hashscraper

HashScraper MCP

通过 AI Agent 收集公开网络数据。询问“总结一下今天 Coupang 上 커피믹스 品类排名前 30 的价格”，HashScraper MCP 服务就会获取该品类的每日畅销榜单，其中包含价格、评论、配送和详情页等列；也可以运行 120 多个现成的数据机器人（Naver 博客／咖啡馆／新闻／购物、Instagram、YouTube、Olive Young、Musinsa、Kurly、KREAM、Google／Kakao 地图、应用商店、社区论坛等）。

• 无需编写爬虫代码，也无需在本地安装浏览器。只需 Node.js 20+ 和一行配置。
• 每个账户每天都会获得免费额度（韩国标准时间午夜补充）。除非你要求使用自己的额度，否则服务只会使用每日免费额度。
• API 密钥仅保存在你的电脑上（~/.config/hashscraper/credentials，只有你能读取），绝不会显示给 Agent。

主页：https://www.hashscraper.com/mcp?utm_source=mcp&utm_medium=github&utm_campaign=mcp_repo

安装

服务通过 stdio 在本地运行：npx -y @hashscraper/mcp。

Claude Code

claude mcp add hashscraper -- npx -y @hashscraper/mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "hashscraper": {
      "command": "npx",
      "args": ["-y", "@hashscraper/mcp"]
    }
  }
}

Cursor

将以下内容添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "hashscraper": {
      "command": "npx",
      "args": ["-y", "@hashscraper/mcp"]
    }
  }
}

Codex

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.hashscraper]
command = "npx"
args = ["-y", "@hashscraper/mcp"]

MCP Bundle (.mcpb)

要为可安装 .mcpb 文件的应用构建单文件捆绑包（其中包含服务及其依赖项，并会询问是否提供可选 API 密钥）：

npm install && npm run pack:mcpb   # -> server.mcpb

连接一次

让 Agent“连接 HashScraper”（或者直接询问数据）。它会调用 login 工具，返回一个链接和一个 8 位代码。打开链接并登录（或使用 Google 或电子邮件免费注册），确认代码匹配，然后点击批准并连接。接着告诉 Agent 你已批准，它会再次调用 login 并保存密钥。你无需复制或粘贴密钥。

想使用自己的密钥？在我的页面 → API中创建密钥，并在服务的环境中设置 HASHSCRAPER_API_KEY。该密钥的优先级高于已保存的密钥。

试试这些提示词

1. “总结一下今天 Coupang 上 커피믹스 品类排名前 30 的价格。”
2. “Coupang 有哪些类别可以查看排名？比较 에센스 排名前 5 的价格。”
3. “收集 50 篇关于 성수동 카페 的 Naver 博客文章，并将其保存为 CSV。”
4. “这个 Coupang 商品现在的价格是多少？https://www.coupang.com/vp/products/…”
5. “我今天还剩多少免费额度？”

工具

工具	功能	额度
login	在浏览器中连接你的 HashScraper 账户（调用两次：先获取链接，再完成连接）	免费
me	账户电子邮件和今日免费额度	免费
catalog	搜索内置的 120 多个机器人列表及其输入参数	免费
run	使用一个机器人收集数据并返回行（等待最多 55 秒，然后返回数据集 ID）	按行计费，参见 catalog
fetch	通过数据集 ID 获取此前 run 的结果行	免费
coupang_categories	提供每日畅销榜前 30 的 Coupang 类别	免费
coupang_top	获取 Coupang 类别前 30 名及详情列（每天收集一次）	每个快照、每个类别 300；再次获取同一快照免费

大型结果可以使用 csv_path 保存到文件（绝对路径，以 .csv 结尾；编码为 UTF-8 BOM，方便 Excel 读取韩文）。

免费额度

• 免费额度每天午夜（韩国标准时间）补充。未使用的额度不会结转。
• 当日免费额度用完后，工具会停止运行并告知补充时间。只有在你提出要求时，才会使用你自己的额度（use_credits）。

数据条款

数据仅供内部分析使用，不得转售或再分发：https://www.hashscraper.com/data-terms

首次执行会消耗额度的命令前，服务会停止并显示条款。Agent 必须向你展示条款，且只有在你明确同意（accept_terms）后才能继续。每个账户只会询问一次。Agent 不会代你同意。

隐私

该服务仅收集公开页面，绝不会要求登录网站。它只与 HashScraper API（https://www.hashscraper.com/v5/api）通信。保存的密钥位于 ~/.config/hashscraper/credentials（仅所有者可访问），并与 HashScraper Agent Skill 共用。删除该文件即可断开连接，也可以在 我的页面 → API 与集成 中关闭密钥。

还需要其他功能？

缺少网站或 Coupang 类别、每日定时采集，或需要处理大量数据？请发送邮件至 [email protected]，说明网站、所需数据、数据量和采集频率；也可以联系我们：https://www.hashscraper.com/quotes/new?utm_source=mcp&utm_medium=github&utm_campaign=mcp_repo

许可证

MIT。请参阅 LICENSE。