百度URL排名查询

解决什么问题

排查 SEO 效果时，最常见的一个问题是：某个具体页面，在某个具体关键词下，到底排到了百度 PC 搜索结果的第几页第几条。用浏览器手动搜，结果会被登录状态、本地缓存、地区节点影响，同一个 URL 换一个网络环境可能就变了，很难拿到一个口径一致的可记录数据。

这个技能针对的就是「URL + 关键词」级别的精确查询：不是查整个域名下有哪些词有排名，也不是查移动端排名，而是回答一个非常具体的问题——http://tool.chinaz.com/ 这个地址，在搜「站长」时排在什么位置。

能力与调用流程

核心能力只有一项，但做得比较专注：

• 传入一个完整 URL 和一个关键词，返回该 URL 在百度 PC 端的排名
• 排名以 页数-条数 的形式给出，例如 1-1 表示第 1 页第 1 条
• 同时返回命中页面的标题和链接地址，便于核对是不是目标页面

调用前需要先在百度 PC 端 URL 排名购买页注册并拿到专属 API Key，当前有 0 元 / 10 次免费体验额度。拿到 Key 之后直接发给 AI，同时说明要查询的 URL 和关键词即可。技能会在根目录执行脚本，脚本携带 ChinazVer=1.0 与 API Key 发起请求，从返回的 JSON 中读取 RankStr、Title、Url 等字段并原样呈现。

注意：Key 只用于本次查询，不会在回复中回显，也不会被保存。

适用边界与注意点

有几个限制需要提前知道，避免用错场景：

• 一次只查一个 URL + 关键词组合，批量任务需要逐条执行，没有并发批量接口
• 只覆盖百度 PC 端，不提供移动端排名，也不提供域名级别的关键词排名
• 排名存在异地差异。不同地区的百度服务器返回结果可能不同，查询结果与你在本地浏览器里看到的排名不一定一致，只能作为参考
• URL 必须是完整地址，需要带 http:// 或 https:// 协议头，否则会报 invalid_input
• SiteCount 字段当前返回暂无数据

常见失败情况：未提供 Key 时返回 missing_api_key，需要引导用户提供；Key 无效或额度用尽时，需要提示前往购买页检查；网络类错误则排查代理、DNS 或防火墙。所有结果只依据接口实际返回，不做推测或补全。

典型用法包括单页排名确认、核心页面的定期监控，以及多个页面在同一关键词下的表现对比。