关于 domaintrack
domaintrack 是 Domduck 公共域名数据的转发客户端,适用于查询域名声誉和爬虫政策。它提供三种工具,在本地列出工具并将调用转发到无需密钥的公共端点;没有记录的域名会明确标示。
主要功能
- 01域名声誉快照
- 02robots.txt 中的 AI 爬虫政策
- 03llms.txt 发布状态
- 04数据来源目录
适用场景
- 01查询域名已有的声誉信息
- 02检查受跟踪 AI 爬虫的规则
- 03确认域名是否发布 llms.txt
- 04通过来源目录理解数据字段
MCP 相关
向 MCP 客户端提供三种工具,并通过 Streamable HTTP 会话将调用转发到 Domduck 公共端点。工具列表由本地提供,且不会发送凭据。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| domain | string | 是 | 域名。协议、www 和末尾的点会被移除。 |
详细介绍
domaintrack
domaintrack 用于查询某个域名的公开信息: 其声誉概况、robots.txt 设置的 AI 爬虫策略,以及构成这些答案的数据源列表。
它是一个转发客户端,不是数据存储。答案存放在 Domduck 的公共存储中,并由其无需密钥的公共端点提供;此软件包承载该端点的三工具接口,在本地提供工具列表,并将每次调用转发至上游,原样返回上游响应。无需账户或 API 密钥:公共端点就是全部接口。Domduck 的认证端点及其按日期记录的历史序列是独立的,本客户端不会访问它们——本客户端不会发送任何凭据。
在自动化调用前,有一点值得了解:查询一个从未有人查过的域名并不算错误。返回的概况中,hasReading 会设为 false,这表示存储如实说明尚无该域名的记录。
工具
lookup_domain— 某个域名的已存储声誉概况:Domain Rating、Tranco 排名、OpenPageRank、注册日期、TLS 证书状态和 AI 爬虫策略。需要提供domain。get_ai_crawler_policy— 对八种受跟踪的 AI 爬虫,说明该域名的 robots.txt 是允许、阻止还是未提及它们,并说明是否发布了 llms.txt。需要提供domain。list_sources— 另外两个工具所用的数据源目录及各数据源的含义。无需参数;如果不熟悉概况字段,请先读取此项。
命令行
npx @reneturcios/domaintrack lookup_domain '{"domain":"example.com"}'
npx @reneturcios/domaintrack get_ai_crawler_policy '{"domain":"example.com"}'
npx @reneturcios/domaintrack list_sources
npx @reneturcios/domaintrack --version
每个工具子命令都会转发一次调用,并将结果内容以 JSON 格式打印。退出码:成功时为 0;上游调用返回错误结果时为 1;用法错误时为 2(未知子命令、JSON 参数格式错误)。
MCP 服务
npx @reneturcios/domaintrack mcp
MCP 客户端配置:
{
"mcpServers": {
"domaintrack": {
"command": "npx",
"args": ["-y", "@reneturcios/domaintrack", "mcp"]
}
}
}
服务端自行响应 tools/list,并通过 Streamable HTTP 会话将每个 tools/call 转发至公共端点(先 initialize,再 notifications/initialized,然后调用),并在进程运行期间复用该会话;如果端点提供 Mcp-Session-Id,也会一并复用。
网络传输中的故障会以本软件包自己的措辞报告,作为以 domaintrack error: 开头的文本结果——上游 JSON-RPC 错误、非 2xx HTTP 状态、无法解析的响应正文或请求失败,都会映射为该前缀后附带相应详情。
Docker
docker run -i ghcr.io/cloudcorprecords/domaintrack # stdio MCP server
docker run --rm ghcr.io/cloudcorprecords/domaintrack lookup_domain '{"domain":"example.com"}'
配置
DOMDUCK_MCP_URL— 覆盖上游端点,默认值为https://domduck.com/api/mcp/public。(此覆盖设置是我们这边重构添加的;端点本身仍固定为公共端点。)
开发
npm install
npm run build # tsc -> dist/
npm test # node test runner via tsx; stubbed upstream, no network
npm run dev # run the CLI from source
许可证
MIT — 详见 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。