百度PC端排名查询

它解决什么问题

排查 SEO 问题时，最常见的一类疑问是：「我的域名在百度上搜某个关键词排第几？」人工在浏览器里翻页搜索，既慢又不稳定：结果会因地域、缓存、个性化而变化，超过前几页后肉眼统计更是不现实。这个技能把这件事变成一次命令行调用：输入一个域名和一个关键词，拿到结构化的排名结果——位置、标题、链接、收录量——便于脚本化检查、定时巡检或与竞品做横向对比。

技能如何工作

它只封装一个接口：百度PC排名（https://openapi.chinaz.net/v1/1001/baidupc_keywordranking），用途单一明确，不涉及移动端、搜狗或其他搜索引擎。

核心流程如下：

• 提取参数：从用户请求中取出两个必填项——domain（待查询域名）与 keyword（关键词）。域名可带协议或路径输入，脚本会自动去除协议、路径、查询参数与片段。
• 本地脚本执行：在 Skill 根目录运行一个 Python 脚本，只依赖 Python 3 标准库，无需安装任何第三方包。
• 读取密钥并发起请求：脚本从环境变量中读取 API Key（由用户自行配置），向 openapi.chinaz.net 发起 HTTPS GET 请求，携带 domain、keyword、ChinazVer=1.0 与 APIKey。
• 解析 JSON 输出：读取脚本输出的 JSON，仅依据实际返回回答用户，不推断、不补全数据。

返回结果中，StateCode: 1 表示查询成功，关键字段包括：

• RankStr：排名位置，格式为「页数-条数」，例如 1-3 表示第 1 页第 3 条
• Title / Url：排名页面的标题与链接
• SiteCount：该关键词的收录量，可粗略反映竞争强度

错误处理按返回类型分流：

• missing_api_key：环境变量未设置，需配置后重启运行环境
• HTTP 431/432/433/434：Key 缺失、格式不正确或无效
• HTTP 436：Key 不存在或额度不足
• 业务码表示未查到排名：如实说明未进入前 50 名，不猜测具体名次
• 网络类错误：检查网络、DNS、代理或防火墙后重试

适用边界与注意点

• 只看前 50 名：接口不返回 50 名之后的数据，未进入前 50 名就是「无排名数据」，不要据此推断具体位置。
• 地域差异：排名存在异地排名现象，结果与查询 IP 不保证百分百一致，仅供参考。
• 逐条查询：一次只查一个域名的一个关键词；批量任务需循环逐条执行。
• 密钥安全：不要把真实 Key 写进代码、命令行参数、日志或聊天记录；优先使用客户端提供的 Secrets / 环境变量安全存储。
• XiongzhangID 字段已不再返回，可忽略。