百度URL排名查询

功能简介

查询指定URL在百度PC搜索引擎中某个关键词的排名情况，返回排名位置、页面标题、链接地址。排名存在异地差异，结果仅供参考。

核心能力：

查询特定URL在百度PC端的关键词排名
返回排名位置（页数-条数）
同时返回页面标题和链接

适用范围：本 Skill 只覆盖"百度PC端URL排名"接口，不用于百度移动端URL排名、域名级别排名。

使用方式

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

缺少 Key 时的引导回复

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

未检测到 API Key，需要你提供一下在百度PC端URL排名购买页获取的专属 API Key，我才能帮你查询URL。

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

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

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

参数说明

查询流程

从用户请求中提取查询参数。
在 Skill 根目录执行脚本：

python scripts/query_baidupc_url_ranking.py --url "http://tool.chinaz.com/" --keyword "站长" --api-key "用户提供的Key"

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

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

返回字段

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

返回示例：

{"StateCode":1,"Reason":"成功","RankStr":"1-1","Title":"站长工具","Url":"http://tool.chinaz.com/"}

结果解读

StateCode: 1 表示查询成功。
根据返回字段获取具体数据，仅依据实际返回回答用户。
数据仅供参考，排名类数据存在异地排名现象。

推荐答复格式：

百度URL排名查询查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | URL格式不正确 | 确认输入参数格式正确后重试 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

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

使用边界

一次只查询一个URL+关键词组合；批量任务须逐条执行。
数据仅供参考，排名类数据存在异地差异。
不输出、复述或保存 API Key。

应用场景

场景1：查询特定页面排名

你会问："我的这个页面在百度上搜"站长工具"排第几？"

操作步骤：

提取查询参数
执行查询脚本

建议输入：--url http://tool.chinaz.com/ --keyword 站长工具

如何解读结果：从RankStr获取排名位置，如"1-1"表示第1页第1条

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景2：页面排名监控

你会问："核心页面的关键词排名有没有变化？"

操作步骤：

提取查询参数
执行查询脚本

建议输入：--url https://www.example.com/product --keyword 核心关键词

如何解读结果：定期查询核心页面的排名，追踪排名变化趋势

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景3：多页面排名对比

你会问："不同页面对同一关键词的排名哪个更好？"

操作步骤：

提取查询参数
执行查询脚本

建议输入：--url 不同URL --keyword 同一关键词

如何解读结果：分别查询不同URL的排名，对比哪个页面在该关键词上表现更好

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

常见问题

Q：查不到排名怎么办？

A：可能是该URL在百度上没有该关键词的排名，或者排名在50名以后。建议优化页面内容或换一个更精准的关键词。

Q：排名存在异地差异是什么意思？

A：不同地区的百度服务器返回的排名可能不同，查询结果可能与你在浏览器中搜到的排名有差异，仅供参考。

Q：URL需要带http://吗？

A：是的，URL需要是完整的地址，包含http://或https://协议头。