Stophy

Stophy MCP

面向 AI Agent 的网页抓取 API，以 MCP 服务的形式提供。通过一个 API 即可搜索网页、查看人们的评论，以及查找商品、地点、工作和住房。只为获取的答案付费。你的 Agent 可通过三个 MCP 工具访问 Stophy 的所有端点。

连接到托管服务

大多数应用可以直接连接到托管服务，无需安装任何内容。

URL	连接方式	Agent 可使用的功能
https://api.stophy.dev/mcp	无需密钥	端点列表中标记为 keyless: true 的端点，可在免费额度内使用
https://api.stophy.dev/mcp	Authorization: Bearer <key> 标头	所有端点
https://mcp.stophy.dev/mcp	使用浏览器登录	所有端点

前往 stophy.dev/signup 获取 API 密钥。

Claude

在网页版、桌面版或移动版 Claude 中，打开 自定义 > 连接器，选择添加自定义连接器，然后粘贴 https://mcp.stophy.dev/mcp。按 Claude 提示登录。

Claude Code

要使用浏览器登录，请添加服务，然后运行 /mcp 并选择 Authenticate：

claude mcp add --transport http stophy https://mcp.stophy.dev/mcp

要使用 API 密钥：

claude mcp add --transport http stophy https://api.stophy.dev/mcp --header "Authorization: Bearer <key>"

要在不使用密钥的情况下启动：

claude mcp add --transport http stophy https://api.stophy.dev/mcp

Codex

要使用环境变量 STOPHY_API_KEY 中的密钥：

codex mcp add stophy --url https://api.stophy.dev/mcp --bearer-token-env-var STOPHY_API_KEY

要改用浏览器登录，请添加登录 URL，然后登录：

codex mcp add stophy --url https://mcp.stophy.dev/mcp
codex mcp login stophy

Cursor

使用上方的添加到 Cursor按钮，通过浏览器登录；或者将以下内容添加到 .cursor/mcp.json，以使用密钥：

{
  "mcpServers": {
    "stophy": {
      "url": "https://api.stophy.dev/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

要在不使用密钥的情况下启动，请省略 headers。

将其作为本地服务运行

有些应用只能启动本地 MCP 服务。对于这些应用，请使用此软件包。它会在你的电脑上运行，并将所有请求转发到托管服务，因此可使用的工具始终相同。

npx -y @stophy/mcp

设置 STOPHY_API_KEY 后，你的 Agent 可以使用所有端点。不设置时，你的 Agent 可在免费额度内使用无需密钥的端点。

Claude Desktop

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

{
  "mcpServers": {
    "stophy": {
      "command": "npx",
      "args": ["-y", "@stophy/mcp"],
      "env": { "STOPHY_API_KEY": "<key>" }
    }
  }
}

要在不使用密钥的情况下启动，请省略 env。

此软件包需要 Node.js 18 或更高版本。

变量	作用
STOPHY_API_KEY	你的 Stophy API 密钥。可选。
STOPHY_MCP_URL	要连接的服务。默认值为 https://api.stophy.dev/mcp。

工具

工具	作用
stophy_search_endpoints	查找适合某项任务的端点及其费用
stophy_describe_endpoint	显示端点接受的输入及其返回内容
stophy_call	使用 id、input 和可选的 fields 调用端点，并返回 JSON

你的 Agent 通常会先搜索，再查看端点说明，然后进行调用。端点 ID 使用小驼峰命名法，例如 googleSearch 或 youtubeSearch。列表会以 results 的形式返回，而 fields 只保留你指定的各行键。每项结果都会说明消耗的额度。

指定某个对象时，只发送它的链接或 ID，不能同时发送两者：videoUrl 或 videoId、placeUrl 或 placeId、userUrl 或 username。端点说明中会列出对应的两种参数。

每次调用会从网站获取一页内容，费用以该端点标示为准。大多数调用消耗 1 个额度，有些消耗 2 个额度；长列表每 10 条结果消耗 1 个额度。一些列表端点接受 page 并返回 page：请求下一个页码，并在 results 为空时停止。其他端点在还有更多结果时会返回 cursor：将其原样作为 cursor 传回，以获取下一页。

网络与凭据

• 托管服务位于 https://mcp.stophy.dev/mcp（登录）和 https://api.stophy.dev/mcp（无需密钥或使用 API 密钥）。你的客户端只会向这两个地址发送请求。
• 凭据：由你的 MCP 客户端处理浏览器登录，或由你自行设置可选的 STOPHY_API_KEY。本地软件包也会读取可选的 STOPHY_MCP_URL。
• 插件清单（.mcp.json、.grok-plugin/plugin.json、mcp.json、plugin.json）只会指向托管服务，不会在你的计算机上运行任何代码。
• 无遥测。

更多信息

• Stophy 文档
• 控制面板和 API 密钥

许可证

MIT