HTTP状态码查询

功能简介

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

核心能力：

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

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

使用方式

前往网站HTTP状态查询购买页注册登录，获取专属 API Key（0元/10次免费体验）
将 Key 直接发送给 AI
告诉 AI 要查询的网址

缺少 Key 时的引导回复

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

未检测到 API Key，需要你提供一下在网站HTTP状态查询购买页获取的专属 API Key，我才能帮你查询网址。

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

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

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

参数说明

查询流程

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

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

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

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

返回字段

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

返回示例：

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

结果解读

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

推荐答复格式：

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

错误处理

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

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

使用边界

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

应用场景

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

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

操作步骤：

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

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

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

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

场景2：检查重定向设置

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

操作步骤：

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

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

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

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

场景3：网站可用性监控

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

操作步骤：

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

建议输入：--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表示服务器内部错误，说明网站服务器出了问题。需要联系服务器管理员排查。