AI 智能体 API 文档

🤖

站长工具 · 开放 API

为 AI 智能体和开发者提供的网站分析接口，支持 SEO 检测、SSL 验证、性能分析、AI 可信度评估等能力。

REST API JSON 格式无需认证免费调用

⚡ 快速开始

三行命令即可开始分析任意网站：

# 1. 检查服务是否在线
curl https://www.bayihy.cn/tools/api/health

# 2. 分析一个网站
curl -X POST https://www.bayihy.cn/tools/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"url":"baidu.com"}'

# 3. 获取完整 API 文档 (JSON)
curl https://www.bayihy.cn/tools/api/docs

📄 查看 JSON 格式文档

⏱️ 速率限制

所有 /api/* 接口均受速率限制保护，基于 IP + User-Agent 指纹识别客户端。

参数	值	说明
限制	10 次	每个客户端每窗口最多请求次数
窗口	60 秒	滑动时间窗口
识别	IP + UA	MD5 哈希指纹，换 UA 可重置

响应头（每个 /api/ 响应都包含）：

X-RateLimit-Limit: 10 // 窗口内最大请求数 X-RateLimit-Remaining: 7 // 剩余可用次数 X-RateLimit-Window: 60 // 窗口秒数

超限响应（HTTP 429）：

{ "error": "请求太频繁，请 45 秒后重试", "retry_after": 45, // 建议等待秒数 "limit": 10, "window": 60 }

📡 接口列表

GET /api/health 健康检查 · 服务状态探测 ▼

说明

快速探测服务是否在线，返回服务名称、版本、可用端点列表和频率限制信息。适合 AI 智能体在调用其他接口前先检查服务可用性。

响应示例

{ "status": "ok", "service": "site-analyzer", "version": "1.0.0", "endpoints": { ... }, "rate_limit": { "max_requests": 10, "window_seconds": 60 } }

cURL

curl https://www.bayihy.cn/tools/api/health

POST /api/analyze 分析单个网站 ▼

说明

对指定网站进行全面分析，包括 SEO 优化、SSL 证书、页面性能、移动端适配、AI 可信度、ICP 备案等维度。返回综合评分和详细指标。

请求参数

字段	类型	说明
url	string	目标网址必填支持裸域名或完整URL

响应字段

{ "score": int // 综合评分 0-100 "seo": { "title": string, // 页面标题 "meta_description": string, "h1_count": int, "img_without_alt": int, "has_sitemap": bool, "structured_data": list, "open_graph": dict }, "performance": { "response_time": float, // 秒 "content_size_kb": float, "compressed": bool }, "security": { "ssl": bool, "ssl_issuer": string, "ssl_expires": string }, "ai_trust": { "score": int, // AI可信度 0-100 "has_structured_data": bool, "has_open_graph": bool }, "ai_discoverability": { "score": int, // AI可发现性 0-100 "level": string // A/B/C/D 等级 }, "icp_filing": { "has_icp": bool, "icp_number": string, "confidence": int // 0-8 置信度 } }

cURL

curl -X POST https://www.bayihy.cn/tools/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"url":"baidu.com"}'

Python

import requests

resp = requests.post(
    'https://www.bayihy.cn/tools/api/analyze',
    json={'url': 'baidu.com'}
)
data = resp.json()
print(f"评分: {data['score']}, AI可信度: {data['ai_trust']['score']}")

错误码

状态码	说明
400	缺少 url 参数
429	频率限制（10次/60秒）
500	分析失败（目标站点不可达等）

POST /api/batch 批量分析多个网站 ▼

说明

一次请求分析多个网站（最多 10 个），内部使用 5 线程并发处理。适合需要对比多个站点的场景。

请求参数

字段	类型	说明
urls	string[]	网址数组必填最多 10 个

cURL

curl -X POST https://www.bayihy.cn/tools/api/batch \
  -H "Content-Type: application/json" \
  -d '{"urls":["baidu.com","zhihu.com","bilibili.com"]}'

POST /api/dns DNS 解析检测 ▼

说明

检测域名的 DNS 解析结果，返回 IPv4 和 IPv6 地址列表。

请求参数

字段	类型	说明
domain	string	域名必填

响应字段

{ "domain": string, "resolved": bool, // 是否解析成功 "ipv4": string[], // IPv4 地址列表 "ipv6": string[], // IPv6 地址列表 "count": int // 总 IP 数 }

cURL

curl -X POST https://www.bayihy.cn/tools/api/dns \
  -H "Content-Type: application/json" \
  -d '{"domain":"baidu.com"}'

POST /api/test-ip IP 可达性测试 ▼

说明

测试指定 IP 的 443 端口是否可达，支持指定 SNI 主机名。适合诊断网络连通性问题（如 GFW 封锁）。

请求参数

字段	类型	说明
ip	string	IP 地址必填
host	string	SNI 主机名可选

cURL

curl -X POST https://www.bayihy.cn/tools/api/test-ip \
  -H "Content-Type: application/json" \
  -d '{"ip":"110.242.68.66","host":"baidu.com"}'

🧠 AI 智能体集成指南

推荐调用顺序：

GET /api/health — 确认服务在线
POST /api/analyze — 分析目标网站
根据 score 和 ai_trust.score 评估网站质量

注意事项：

无需认证，直接调用
频率限制：10 次/60 秒
分析耗时 5-30 秒，建议设置 60 秒超时
返回数据不存储，每次请求实时分析
批量分析最多 10 个 URL

📋 技能文档：AI 智能体可加载 site-analyzer-api 技能获取完整调用指南，包含 Python 示例、错误处理和最佳实践。