HTTP状态码查询

功能简介

查询网站的HTTP响应状态码，快速判断网站是否正常访问（200）、是否重定向（301/302）、是否存在错误（404/500）等问题。

核心能力：

• 获取网站HTTP响应状态码
• 返回网站响应IP地址
• 支持是否跟随重定向的选项

适用范围：本 Skill 只覆盖"网站HTTP状态查询"接口，不用于网站性能测试、页面内容分析。

快速开始

只需三步即可开始使用：

运行要求

• 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
• Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
• 能够向 https://openapi.chinaz.net 发起 HTTPS 请求。
• 运行 AI 客户端的环境可读取环境变量。

如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。

获取与配置 API Key

第一步：购买接口

在 网站HTTP状态查询购买页 购买接口并获取专属 API Key。该接口提供 0元/10次 的免费体验额度，适合先试用再决定是否购买付费套餐。

第二步：设置环境变量

将 Key 保存为环境变量，变量名必须是：

CHINAZ_HTTP_STATUS_CHECK_API_KEY

Windows：搜索并打开"编辑账户的环境变量" → 在"用户变量"中新增该变量 → 变量值填入购买后获得的 Key → 确定保存。

macOS / Linux（当前终端会话临时生效）：

export CHINAZ_HTTP_STATUS_CHECK_API_KEY='你的专属APIKey'

如需永久生效，将上述命令添加到 ~/.bashrc 或 ~/.zshrc 中。

第三步：重启生效

重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

安全提醒：不要把真实 Key 写入 SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。

参数说明

| domain | string | 必填 | 需要查询的网址 | chinaz.com | | allowAutoRedirect | string | 必填 | 是否重定向响应(值为true/false) | true |

查询流程

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

python scripts/query_http_status_check.py --domain "chinaz.com" --allowAutoRedirect "true"

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本读取环境变量中的 Key，并调用接口 https://openapi.chinaz.net/v1/1001/statuscode，发送请求参数与 ChinazVer=1.0 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

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

| StateCode | int | 状态码 | | Reason | string | 状态码描述 | | Result.RemoteAddr | string | 网站响应IP | | Result.Status | string | 网页状态 | | Result.StatusCode | int | 网页状态码 |

返回示例：

{"StateCode":1,"Result":{"RemoteAddr":"117.25.139.77:80","Status":"301 Moved Permanently","StatusCode":301},"Reason":"成功"}

结果解读

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

推荐答复格式：

HTTP状态码查询查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

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

使用边界

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

应用场景

场景1：检测网站是否正常

你会问："我的网站现在能正常访问吗？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--domain chinaz.com --allowAutoRedirect true

如何解读结果：StatusCode为200表示正常，301/302表示重定向，404表示页面不存在，500表示服务器错误

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

场景2：检查重定向设置

你会问："网站有没有做301重定向？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--domain chinaz.com --allowAutoRedirect false

如何解读结果：设置allowAutoRedirect为false，如果返回301说明有重定向，查看Status字段了解重定向类型

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

场景3：网站可用性监控

你会问："网站服务器IP是多少？状态正常吗？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--domain chinaz.com --allowAutoRedirect true

如何解读结果：从RemoteAddr获取响应IP，StatusCode判断状态，定期监控网站可用性

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

常见问题

Q：301和302有什么区别？

A：301是永久重定向，搜索引擎会将权重转移到新地址；302是临时重定向，权重不转移。SEO建议用301。

Q：allowAutoRedirect设true还是false？

A：true会跟随重定向返回最终页面状态码；false返回原始重定向状态码。想检查重定向设置用false，想看最终状态用true。

Q：状态码500是什么意思？

A：500表示服务器内部错误，说明网站服务器出了问题。需要联系服务器管理员排查。