百度收录量查询

功能简介

输入一个域名，快速查询该网站在百度搜索引擎中被收录的页面总数。就像给你的网站做一次"体检"，看看百度一共收录了多少个页面。

核心能力：

查询任意域名在百度的收录量（收录页面总数）
返回收录量数值，便于评估网站在百度的收录规模
支持任意合法域名查询，结果实时返回

适用范围：本 Skill 只覆盖"百度收录量"接口（BD收录量），不用于查询单个 URL 是否被收录、移动端收录量或其他搜索引擎收录量。

使用方式

前往百度收录量接口购买页注册登录，获取专属 API Key（0 元/10 次免费体验额度）
将 Key 直接发送给 AI
告诉 AI 要查询的域名

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时，按以下方式回复用户（根据实际查询内容调整）：

未检测到 API Key，需要你提供一下在百度收录量接口购买页获取的专属 API Key，我才能帮你查询域名。

请直接把 Key 发给我，我会仅用于本次查询，不会保存或回显完整密钥。

查询失败（Key 无效或额度不足）时，引导用户前往购买页检查 Key 或额度。

以下为内部执行参考，回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

| 参数 | 类型 | 是否必填 | 说明 | 示例 | |------|------|---------|------|------| | domain | string | 必填 | 待查询的域名，不需要带 http:// 或 https:// | chinaz.com | | APIKey | string | 必填 | 购买接口时获取的 API Key（通过环境变量传入，无需手动传参） | — | | ChinazVer | string | 必填 | API 版本号，固定为 1.0（脚本自动传入） | 1.0 |

查询流程

从用户请求中提取待查询的域名（如 chinaz.com）。
在 Skill 根目录执行脚本：

python scripts/query_baidupc_domain_include.py --domain chinaz.com --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_BAIDUPC_DOMAIN_INCLUDE_API_KEY，可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

脚本使用 Key 调用接口发送 domain、ChinazVer=1.0 与 APIKey。
从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

成功查询后，返回 JSON 包含以下字段：

| 字段名 | 类型 | 说明 | |--------|------|------| | StateCode | int | 状态码，1 表示查询成功 | | Reason | string | 状态说明 | | SiteCount | int | 百度收录量（被百度收录的页面总数） |

返回示例：

{
  "StateCode": 1,
  "Reason": "成功",
  "SiteCount": 15230
}

结果解读

StateCode: 1 表示查询成功。
SiteCount 是核心字段，表示该域名在百度搜索引擎中被收录的页面总数。数值越大，说明网站被百度收录的内容越多。
收录量是衡量网站 SEO 健康度的重要指标之一，收录量越高，网站在百度搜索中获得曝光的机会越大。
数据仅供参考，存在异地节点差异和更新延迟，不保证与实际搜索结果完全一致。

推荐答复格式：

百度收录量查询结果
- 查询域名：chinaz.com
- 查询状态：成功
- 百度收录量：15,230 个页面

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | 域名格式不正确 | 确认输入的是有效域名（如 chinaz.com），不要带协议头和路径 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

其他失败状态：按返回的 Reason 或 JSON 错误信息说明问题，不得编造数据。

使用边界

一次只查询一个域名；批量任务须逐条执行。
收录量数据仅供参考，存在地区差异和更新延迟，不保证与 site: 指令查询结果完全一致。
不输出、复述或保存 API Key。

应用场景

场景一：查询网站百度收录量

你会问："我的网站百度收录了多少页面？"

操作步骤：

准备好要查询的域名（如 example.com）
运行脚本查询

建议输入：--domain example.com

如何解读结果：查看 SiteCount 字段的数值，这就是该域名在百度搜索引擎中被收录的页面总数。如果收录量为 0，可能网站尚未被百度抓取，或存在技术障碍阻止百度蜘蛛访问。

后续建议：如果收录量较低，建议检查 robots.txt 是否屏蔽了百度蜘蛛、提交 sitemap 到百度搜索资源平台、优化网站内链结构。

场景二：分析竞品网站收录规模

你会问："竞品网站的百度收录量是多少？跟我的网站比怎么样？"

操作步骤：

分别查询自己网站和竞品网站的域名
对比两者的收录量数值

建议输入：--domain competitor.com（再查自己的域名）

如何解读结果：对比两个域名的 SiteCount 值。如果竞品收录量远高于自己，说明竞品网站内容更丰富或被百度抓取更充分，可能在搜索排名上有优势。

后续建议：分析竞品网站的内容策略，增加高质量原创内容，提升自身网站的收录量。

场景三：监控网站收录量变化趋势

你会问："最近网站收录量有没有变化？是不是被降权了？"

操作步骤：

定期（如每周）查询同一域名的收录量
记录每次查询的数值和时间

建议输入：--domain example.com

如何解读结果：关注 SiteCount 的变化趋势。如果收录量持续增长，说明网站内容被百度持续抓取和收录；如果收录量突然大幅下降，可能意味着网站被降权或存在技术问题。

后续建议：收录量骤降时，立即检查网站是否有大量页面返回错误码、是否被百度惩罚、服务器是否稳定等，及时修复问题。

常见问题

Q：查询到的收录量和我在百度用 site: 指令查到的不一样？

A：这是正常现象。site: 指令返回的是近似值，且会受查询地点和时间影响；本接口返回的是站长工具统计的收录量数据，两者统计口径不同，可能存在差异。建议以趋势变化为主，不必纠结绝对数值的精确性。

Q：免费额度用完了怎么办？

A：免费体验额度为 0 元/10 次，用完后可前往购买页购买付费套餐，最低 10 元/1000 次（约 0.01 元/次），性价比很高。

Q：收录量很低甚至为 0，是不是我的网站有问题？

A：不一定。新上线的网站通常需要一段时间才能被百度充分收录。建议先到百度搜索资源平台提交 sitemap，检查 robots.txt 是否允许百度蜘蛛抓取，确保服务器稳定可访问。如果网站上线已超过 1 个月收录量仍为 0，可能需要排查技术问题。