数据工具/ mcp

一个 MCP 磁共振 允许克劳德(或任何) MCP 兼容客户端)查询您的 DataDive 特长,关键词,竞争者,以及 使用您已有的 API 键排名雷达数据 .

在你的机器上运行 在Stdio。 您的 API 键从不离开您的机器 除外 x-api-key 请求中的标题 api.datadive.tools。 。 。 .

你可以问什么

• "给我的DataDive 在市场上的优势 com""("史记")
• "什么是主关键词列表的特色 z515cGOFg3? 吗
• "谁是X特长的顶尖竞争者,他们的销售量是多少?"
• "我的排行榜是什么样的"X"——哪里可以改进
• "给我看看我的军衔雷达"
• "标出2024-03-01至2024-04-01年军衔雷达Y的有机排名趋势"
• 与5名竞争者一起在美国市场跑跑一跑
• "与今日数据,同为竞争对手的再现特色X"
• "有12个竞争对手但将B08N5WWWW保留在剧组中的"再入选""特快X"
• "我的潜水完成了吗?"
• "开始一个等级雷达 跟踪10个关键词 为ASIN B08N5WWW 在特殊X。"
• "亚马逊卖家的账户是连通的?"
• "搜索我的目录 为活跃的'Widget'产品在美国。"
• "上周我的上市价格或内容发生了什么变化?"

1. 获取 DataDive API 密钥

1. 签名于 https://2.datadive.tools (英语)。 。 。 .
2. 转到 设置 ~ API 密钥 (单位:千美元)/api-key) (中文(简体) ).
3. 点击 生成 API 密钥。将数值复制到您的 MCP 中 下面的客户端配置 .

要求 账单管理器 或者说 拥有者 作用和作用 标准计划 或更高。如果无法看到页面,请联系您的管理员.

2. 添加到您的 MCP 客户端

克劳德桌面

编辑您的配置文件 :

• 马可斯: ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗口 : %APPDATA%\Claude\claude_desktop_config.json

添加数据 datadive 条目 mcpServers数字 :

{
  "mcpServers": {
    "datadive": {
      "command": "npx",
      "args": ["-y", "@datadive-tools/mcp"],
      "env": {
        "DATADIVE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

重新启动克洛德桌面. 你应该看看 datadive 在工具菜单中.

克劳德代码

claude mcp add datadive -- npx -y @datadive-tools/mcp
# Then add the env var via:
#   claude mcp add datadive --env DATADIVE_API_KEY=YOUR_API_KEY -- npx -y @datadive-tools/mcp

或者编辑 .mcp.json 在您的项目中 / ~/.claude/mcp.json 与全球 和上面的JSON形状一样.

光标

设置 → MCP → 添加新的 MCP 服务器 粘贴同样的JSON形状:

{
  "datadive": {
    "command": "npx",
    "args": ["-y", "@datadive-tools/mcp"],
    "env": { "DATADIVE_API_KEY": "YOUR_API_KEY" }
  }
}

3. 核实

问克洛德: "给我的DataDive特长"

你应该看到一个工具呼叫 list_niches 和JSON的反应与你的 特殊区域,加上页形元数据。 如果你没有,看下面的麻烦解决.

可用工具

所有数据都被设定为拥有API密钥的组织. 大多数工具是 只读。 改变某事的工具在上方标出 无法被还原,还需要明确 confirm: true 看到了吗 改变事物的工具。 。 。 .

改变事物的工具

六个工具 无法被撤销因此,它们需要明确 confirm: true 参数。 没有它,他们就一无所有 并返回一张纸条问 助理先与您确认成本 :

• create_niche_dive, (中文(简体) ), redive_niche ——花下潜符号(尺度与 numberOfCompetitors) (中文(简体) ).
• create_rank_radar —— 使用搜索时标符( 尺度与 numberOfKeywords) (中文(简体) ).
• generate_listing_copy ——每通电话需花1个AI抄写员即时支付.
• delete_niche, (中文(简体) ), delete_rank_radar ——永久销毁数据.

随时检查您的余额 get_quota。 。 。 .

create_rank_radar 首先使用未经证实的呼叫预览创建 反API,所以它回来的纸条 可以告诉你一些具体的东西 而不是仅仅象征性的成本,例如,你要求的产品家庭 已经追踪到你的另一台雷达 将会花去追踪 搜索条件两次 预览片没有创造,也没有花费,还有 警告永远不要阻止创造: 一个家庭的两个Rank雷达是怎样的 跟踪两套不同的搜索术语,并保存单独的统计.

其他写作工具—— pause_rank_radar, (中文(简体) ), resume_rank_radar 和三个 *_rank_radar_search_terms 工具——不需要确认。 他们只搬家 跟踪键字容量,当您暂停时再次释放,每个键字都是 被对方所推翻.

add_niche_keywords 请求 confirm: true 只有在它花费: 在过去的24小时里,它的首次呼叫中加入了免费的关键词,同时 更古老的地盘上 呼唤什么也不会改变 并回报潜水费 重新跳动附加触发器. remove_niche_keywords 和关键词排除 工具是免费的,不需要确认.

跳过每次呼叫确认(例如自动设置),设置 DATADIVE_AUTO_CONFIRM_WRITES=true 在客户端配置中——然后全部6跑 无 confirm中,删除.

三个都没有 安全可重试 ——每通电话都会再次花去代币 创建单独的下潜 / 重潜 / Rank Radar, 即使有相同的参数 。 若为 调用错误或出错时间, 请检查 get_dive_status 编号 : list_niches 编号 : list_rank_radars 之前已经存在的东西 再次打电话.

潜水是 一个同步。 。 。 . create_niche_dive 返回 a diveId 还有一个 立即估计完成时间;民意调查 get_dive_status 与那个 diveId 直到它报告 success,带有新的 nicheId 然后输入到 list_niches, (中文(简体) ), get_niche_keywords,以及其它特殊工具.

redive_niche 刷新你已有的空间 而不是创建另一个 一,它保持不变 nicheId 雷达和报道的等级 位置跟踪更新后的数据。 它需要一个 mode数字 :

• same_competitors ——重新划入"优势"当前竞争对手套装. 没别的了 (d) 完全用于调取当前销售、价格和关键词数据.
• discover - 寻找一套新的竞争对手 numberOfCompetitors (原始内容存档于2018-09-21). AsINs. 跟着它 heroAsin (原始内容存档于2018-09-21) (原始内容存档于2017-09-21). field to the lic's 最高销售竞争者, 更喜欢你自己的一个ASIN, lockedAsins (无论发现什么)和 excludedAsins (从未被选中).

为: create_niche_dive, (中文(简体) ), marketplace 使用完整的 Amazon 域名后缀 (单位:千美元)com, (中文(简体) ), co.uk, (中文(简体) ), com.mx, (中文(简体) ), co.jp——例如,联合王国的市场是: co.uk, (中文(简体) ), 没有 uk。 。 。 .

配置

解决问题

如果一个工具调用返回一个错误消息, 它将会是其中之一—— 每个地图到一个 来自 DataDive API 的特定 HTTP 状态.

如果服务器本身无法启动, 请查看您的 MCP 客户端的日志输出 :

• DATADIVE_API_KEY environment variable is required - 地狱不是 被传递到二进制。 确认您的客户端配置 env (无) args),并且在编辑后重新启动了客户端.

隐私

• MCP服务器在您的机器上运行 。 它是一个薄薄的Shim——每一个工具 调用从您的机器变为一个 HTTPS 请求 api.datadive.tools 以您的 API 键为 x-api-key 头曰.
• 您的 API 密钥只存储在您的 MCP 客户端的配置文件中( 您的配置文件) 控制)。 它从未被送到别的地方.
• 服务器本身没有日志 。 DataDive 的标准后端访问日志 按要求记录元数据(组织、路线、状况、延迟) 任何直接API电话都会这样.

发展

npm install
npm run build       # tsup -> dist/index.js (with shebang)
npm test            # vitest run
npm run typecheck   # tsc --noEmit
npm run lint        # eslint

用 MCP 检查员测试二进制端到端 :

DATADIVE_API_KEY=YOUR_API_KEY npx @modelcontextprotocol/inspector dist/index.js

释放

回购使用 更改数字 :

npx changeset             # add a changeset describing the change (patch/minor/major)
git commit -am "fix: ..."
git push

"Version套件"PR自动打开. 合并它撞出版本, 更新 ChangeGELOG.md,并以出处发布到npm.

支助

• 问题: https://github.com/Data-Dive-Tools/datadive-mcp/ issues (中文(简体) )
• API 文档 : https://developer.datadive.tools/docs#/v1 互联网档案馆的存檔,存档日期2013-12-02
• 数据驱动支持 : 支持@ datadive.tools

许可证

麻省理工学院——见 自由主义。 。 。 .