NetAPI

NetAPI MCP 服务

一个 MCP 服务，可让 AI 助手和 Agent（Claude、Cursor、ChatGPT、Windsurf、VS Code Copilot 及任何其他 MCP 客户端）访问 NetAPI 域名情报：1,584 个 TLD 的已注册域名、新注册和已删除域名、DNS 提供商和注册商数据、免费的 NetAPI Top 1M 热度排名，以及被入侵域名信息源。

端点（Streamable HTTP）：

URL	使用者	内容
https://mcp.netapi.com/mcp	已登录的 NetAPI 账户（OAuth，或 Authorization: Bearer <api_token>）	所有工具；免费账户即可使用免费的工具并享有更高限额，套餐可解锁付费工具
https://mcp.netapi.com/mcp/public	无需账户	仅限免费工具（此处不会列出账户和套餐工具），适用匿名使用限额

工具

免费（无需套餐）：

工具	可查询内容
check_compromised	此域名是否出现在被入侵域名信息源中（恶意软件、网络钓鱼、滥用）？最近 24 小时内或曾经出现过、拦截原因、注册商。
search_new_domains	最近 1-7 天注册且包含某字符串的域名：品牌监控、域名抢注、网络钓鱼、关键词趋势。
tld_stats	TLD 的注册管理机构、活跃域名数、24 小时内新增 / 删除域名数、7-365 天的增长情况、滥用率、是否出现在 Top 1M 中，以及相关政策。
domain_rank	域名在 NetAPI Top 1M 中的排名，以及在其 TLD 内的排名。
top_websites	某个国家或 TLD（德国 = .de、.fr、.io ...）最热门的网站。
top_1m	Top 1M 列表中的一部分。
registrar_info	注册商的规模、排名和滥用率。
dns_provider_info	DNS 提供商的域名数、市场份额和增长情况。
list_zones	全部 1,584 个区域及其数据。

使用 NetAPI 套餐：

工具	可查询内容
lookup_domain	域名的名称服务器、IP、国家、注册 / 到期日期、注册商。
get_download_url	有效期为 24 小时的域名列表或数据集文件链接：某个区域（活跃 / 新增 / 已删除，一个或全部区域）、DNS 提供商或注册商的域名。列表 = 域名（任何套餐均可）；数据集 = 每个域名一行，包含名称服务器、IP、国家、电子邮件、电话号码（Plus 或 Pro）。
account_info	已连接账户的套餐和限额。

免费数据（Top 1M、被入侵域名信息源）以 CC BY 4.0 许可发布：请注明 NetAPI，并链接到 https://netapi.com/。工具的完整说明和连接步骤：netapi.com/help/mcp/。

连接

此服务使用标准 MCP OAuth（授权服务器 https://netapi.com、动态客户端注册、PKCE），因此支持该功能的客户端在添加 https://mcp.netapi.com/mcp 时会显示 NetAPI 登录界面：使用电子邮件验证码或 Google 登录，点击 允许访问 即可。已连接的应用会列在你的控制面板中，你可以在此断开连接。

claude.ai / Claude Desktop： Settings → Connectors → Add custom connector → URL https://mcp.netapi.com/mcp → Connect。

ChatGPT： 从 ChatGPT 插件目录安装 NetAPI，并按提示登录。开发者模式仍可使用：Settings → Connectors → Add → MCP server URL https://mcp.netapi.com/mcp，身份验证方式选择 OAuth。

Claude Code

claude mcp add --transport http netapi https://mcp.netapi.com/mcp

然后在 Claude Code 中运行 /mcp 登录。无需账户时：

claude mcp add --transport http netapi https://mcp.netapi.com/mcp/public

Cursor（~/.cursor/mcp.json 或项目的 .cursor/mcp.json）：添加 URL 时，Cursor 会通过 OAuth 登录；也可以使用 NetAPI API 令牌：

{
  "mcpServers": {
    "netapi": {
      "url": "https://mcp.netapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

**其他客户端：**添加一个类型为“http” / “streamable-http”的远程 MCP 服务，并使用上述其中一个 URL。

速率限制

无需账户（/mcp/public）：按 IP 计算，点查每分钟 30 次、每天 1,000 次；列表工具为 10 / 200 次；search_new_domains 为 6 / 100 次（每次调用返回 100 条结果）。免费 NetAPI 账户可将限制提高至 60 / 5,000 次、30 / 1,000 次和 30 / 500 次（每次调用返回 500 条结果）；付费计划可进一步提高限制、解锁 lookup_domain、lookup_ip 和 get_download_url，且 Pro 没有每日上限。限制和错误消息由 JSON API 提供：请参阅请求限制表和 MCP 服务页面。

工作原理

Worker 是一个精简层：每次工具调用都会向 NetAPI JSON API（https://netapi.com/api-json/）发送一个 GET 请求，并将结果以 JSON 文本形式返回给客户端。令牌由网站验证并缓存一分钟；Worker 不会存储其他内容。/.well-known/oauth-protected-resource 会将客户端指向授权服务器。文件不会通过它传输：get_download_url 会返回一个临时链接。

开发

npm install
npm run typecheck
npm run dev        # http://localhost:8787/mcp (and /mcp/public)
npm run deploy     # wrangler deploy (or connect the repo in the Cloudflare dashboard)

使用 MCP Inspector 进行测试：npx @modelcontextprotocol/inspector，添加一个 Streamable HTTP 服务，地址为 http://localhost:8787/mcp/public（或使用生产环境 URL 测试登录）。

MCP Registry

该服务已在 MCP Registry 中登记为 com.netapi/mcp（远程地址为 https://mcp.netapi.com/mcp）；server.json 是其清单。发布新版本：更新 server.json 中的 version，运行 mcp-publisher login http --domain netapi.com（通过 /.well-known/mcp-registry-auth 验证域名；也可使用 dns），然后在此目录中运行 mcp-publisher publish。

许可证

本仓库中的代码采用 MIT 许可证。NetAPI 数据受服务条款约束；免费数据集采用 CC BY 4.0 许可证。