---
name: domain-trust-security-check
description: "当用户需要使用咕咕数据公开 API 完成域名可信体检、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 域名可信与站点安全体检 Skill

面向域名可信体检、站点安全巡检、品牌域名管理和上线前检查的公开 API 组合。

## 业务场景

用于域名可信体检、站点安全巡检、品牌域名管理、上线前检查和可疑链接复核。适合把 SSL、DNS、Whois、favicon、页面性能、网站快照、链接提取、正文抽取、国际 IP 定位和搜索可见性组合成站点可信检查链路。

- 数据范围：覆盖 SSL 证书、DNS 查询、Whois、favicon、页面性能、网站快照、网页链接、正文抽取、国际 IP 定位和搜索可见性。
- 关键数据维度：域名维度：域名、DNS 记录、证书、Whois、favicon、服务器 IP 和地区。；页面维度：URL、快照、链接、正文、性能和可见性。；风险维度：证书到期、解析异常、页面不可读、外链异常和品牌提及缺失。

## 何时使用

- 检查域名解析、SSL 证书、Whois 归属、站点标题图标和服务器地区。
- 对上线前页面做性能、快照、链接和正文可读性检查。
- 对品牌域名、活动域名或可疑链接做基础可信复核。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

## 用户需要提供的信息

- 域名、目标 URL、上线时间、品牌名、服务器地区、证书要求和需要检查的页面列表。
- 输出目标：SSL 证书检查、DNS 检查、Whois 归属、站点快照、外链结构、页面质量或上线前体检。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先用 SSL、DNS、Whois、favicon 和 IP 定位接口检查域名基础可信信息。
2. 再用快照、链接、正文和页面性能接口检查页面可访问性。
3. 最后结合搜索可见性接口观察上线后页面和品牌是否被搜索入口识别。

## 参数传递关系

- 域名先传给 SSL、DNS、Whois、favicon 和国际 IP 定位接口，形成站点可信基础信息。
- 目标 URL 继续传给快照、链接提取、正文抽取和页面性能接口，判断页面是否可访问、可读和可被检索。
- 搜索可见性接口用于观察上线后品牌或页面是否被搜索入口识别，不能替代安全扫描。
- 证书到期、DNS 异常、Whois 信息和页面抓取失败需要分开记录，避免把所有问题归为单一故障。

## 典型任务模板

- 上线前体检：输入域名和首页 URL；输出 SSL、DNS、Whois、favicon、页面性能和快照结果。
- 品牌域名巡检：输入多个域名；输出证书有效期、解析结果、站点标题、IP 地区和风险分组。
- 安全信任复核：输入可疑 URL；输出页面快照、外链、正文、证书和人工复核建议。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 域名 SSL 证书信息解析

- 业务角色：SSL 证书
- 调用阶段：域名基础
- 接口地址：`GET https://api.gugudata.com/v2/websitetools/sslcertinfo`
- 产出用途：用于检查域名证书信息。
- 参数来源：域名来自待体检站点、品牌域名清单或上线前检查任务
- 接口资料：详情页 https://www.gugudata.com/api/details/sslcertinfo；接口 Markdown https://www.gugudata.com/api/details/sslcertinfo/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `domain` | 是 | `string` | YOUR_VALUE | 需要解析的域名，格式为 https://www.gugudata.com | 域名来自待体检站点、品牌域名清单或上线前检查任务 |

### 域名 DNS 信息查询

- 业务角色：DNS 查询
- 调用阶段：域名基础
- 接口地址：`GET https://api.gugudata.com/v2/websitetools/dns-lookup`
- 产出用途：用于检查域名解析记录。
- 参数来源：域名来自待体检站点、品牌域名清单或上线前检查任务
- 接口资料：详情页 https://www.gugudata.com/api/details/dnslookup；接口 Markdown https://www.gugudata.com/api/details/dnslookup/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `domain` | 是 | `string` | YOUR_VALUE | 需要解析的域名，格式为 gugudata.com | 域名来自待体检站点、品牌域名清单或上线前检查任务 |

### 域名 Whois 查询

- 业务角色：Whois 查询
- 调用阶段：域名基础
- 接口地址：`GET https://api.gugudata.com/v2/websitetools/whois`
- 产出用途：用于查询域名注册信息。
- 参数来源：域名来自待体检站点、品牌域名清单或上线前检查任务
- 接口资料：详情页 https://www.gugudata.com/api/details/whois；接口 Markdown https://www.gugudata.com/api/details/whois/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `domain` | 是 | `string` | gugudata.com | 需要查询的域名，不需要带 http 或 https 协议。 | 域名来自待体检站点、品牌域名清单或上线前检查任务 |

### 获取任意站点标题与图标

- 业务角色：标题与图标
- 调用阶段：站点基础
- 接口地址：`GET https://api.gugudata.com/websitetools/favicon`
- 产出用途：用于获取站点标题和 favicon。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口资料：详情页 https://www.gugudata.com/api/details/favicon；接口 Markdown https://www.gugudata.com/api/details/favicon/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | YOUR_VALUE | 需要解析的站点 URL | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |

### 网页性能与 SEO 评分

- 业务角色：页面性能评分
- 调用阶段：页面质量
- 接口地址：`GET https://api.gugudata.com/websitetools/pagespeed-score`
- 产出用途：用于检查页面质量。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口资料：详情页 https://www.gugudata.com/api/details/pagespeed-score；接口 Markdown https://www.gugudata.com/api/details/pagespeed-score/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 需要检测评分的网页 URL，必须是有效的 HTTP 或 HTTPS 链接，例如：https://www.baidu.com。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `strategy` | 否 | `string` | mobile | 检测策略，可选 mobile 或 desktop，默认 mobile。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `locale` | 否 | `string` | zh-CN | 返回语言区域，默认 zh-CN。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `categories` | 否 | `string` | - | 评分类别，可选 performance、accessibility、best-practices、seo；多个值用英文逗号分隔，不传时返回全部类别。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `forceRefresh` | 否 | `boolean` | false | 是否重新检测并刷新结果，默认 false；false 时可优先返回近期已有检测结果。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 网站截图与 HTML 快照

- 业务角色：网站快照
- 调用阶段：页面质量
- 接口地址：`POST https://api.gugudata.com/websitetools/url2snapshot`
- 产出用途：用于获取页面截图和 HTML 快照。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；号码来自用户输入、表单线索或上一轮内容抽取结果
- 接口资料：详情页 https://www.gugudata.com/api/details/url2snapshot；接口 Markdown https://www.gugudata.com/api/details/url2snapshot/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | https://www.example.com | 需要截图的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `responseFormat` | 否 | `string` | base64 | 返回格式，可选值：base64（返回 base64 编码的图片数据）、url（返回图片 URL 链接） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `fullPage` | 否 | `boolean` | true | 是否截取完整页面，true 为全页面截图，false 为可视区域截图 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `width` | 否 | `integer` | 1920 | 截图宽度，单位像素，范围：320-3840 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `height` | 否 | `integer` | 1080 | 截图高度，单位像素，范围：240-2160 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `deviceScaleFactor` | 否 | `number` | 1 | 设备像素比，影响截图清晰度，范围：1-3 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `userAgent` | 否 | `string` | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 | 用户代理字符串，用于模拟不同的浏览器 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isMobile` | 否 | `boolean` | false | 是否模拟移动设备，true 为移动设备模式，false 为桌面模式 | 号码来自用户输入、表单线索或上一轮内容抽取结果 |

### 网页 URL 链接提取

- 业务角色：链接提取
- 调用阶段：页面质量
- 接口地址：`GET https://api.gugudata.com/websitetools/url2links`
- 产出用途：用于分析页面链接结构。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口资料：详情页 https://www.gugudata.com/api/details/url2links；接口 Markdown https://www.gugudata.com/api/details/url2links/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | https://www.gugudata.com | 需要提取链接的网页 URL，需包含 http 或 https 协议。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |

### 网页可读内容抽取

- 业务角色：正文抽取
- 调用阶段：页面质量
- 接口地址：`POST https://api.gugudata.com/websitetools/readability`
- 产出用途：用于判断页面正文可读性。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口资料：详情页 https://www.gugudata.com/api/details/readability；接口 Markdown https://www.gugudata.com/api/details/readability/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 否 | `string` | https://www.gugudata.com | 待抽取的网页 URL；url 与 html 至少传入一个。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `html` | 否 | `string` | - | 待抽取的 HTML 原文；url 与 html 至少传入一个。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 国际 IP 地址定位

- 业务角色：国际 IP 定位
- 调用阶段：站点基础
- 接口地址：`GET https://api.gugudata.com/v2/location/ip`
- 产出用途：用于查看服务器地区参考。
- 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
- 接口资料：详情页 https://www.gugudata.com/api/details/internationaliplocation；接口 Markdown https://www.gugudata.com/api/details/internationaliplocation/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `ip` | 是 | `string` | YOUR_VALUE | IP 地址，可以传递 IPv4 或 IPv6 地址 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 搜索可见性 SERP 数据接口

- 业务角色：搜索可见性
- 调用阶段：搜索观测
- 接口地址：`POST https://api.gugudata.com/v1/searchVisibilityReports`
- 产出用途：用于观察品牌和页面可见性。
- 参数来源：域名来自待体检站点、品牌域名清单或上线前检查任务；地区参数来自用户输入、行政区划查询结果或定位结果
- 可参考的相关能力：获取搜索可见性报告、搜索可见性报告列表、创建搜索可见性观测任务、搜索可见性观测任务列表、获取搜索可见性观测任务
- 接口资料：详情页 https://www.gugudata.com/api/details/search-visibility；接口 Markdown https://www.gugudata.com/api/details/search-visibility/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `domain` | 是 | `string` | - | 需要观测的主域名，长度 1-255。可传 gugudata.com 或 https://www.gugudata.com，系统会按主域名规范化。 | 域名来自待体检站点、品牌域名清单或上线前检查任务 |
| `brand` | 是 | `string` | - | 品牌或产品名称，长度 1-120。用于匹配标题、摘要和结果链接中的品牌信号。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `queries` | 是 | `array` | - | 需要观测的搜索关键词列表，1-50 个。创建报告会自动创建首个观测任务，按关键词数量计入 credits 计算。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `sources` | 是 | `array` | - | 搜索来源，1-3 个；支持 google_web、bing_web、baidu_web。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 同等排名深度消耗 10/20/50 credits。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `displayName` | 否 | `string` | - | 报告显示名称，便于在列表中识别，不传时可由业务侧使用 brand/domain 展示。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `aliases` | 否 | `array` | - | 品牌别名列表，最多 20 个；用于补充匹配英文名、简称、产品名等品牌信号。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `competitors` | 否 | `array` | - | 竞品域名定义列表，最多 10 个；每项支持 domain、name、aliases，用于计算竞品排名和差距。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `locale` | 否 | `string` | - | 语言区域提示，如 zh-CN、en-US。不同搜索来源会尽量按该提示观测。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `region` | 否 | `string` | - | 地域提示，如 CN、US、HK。不同地域的排名可能不同。 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `maxRank` | 否 | `integer` | 20 | 观测排名深度，仅支持 10、20、50，默认 20。Google/Bing 分别消耗 1/2/5 credits，Baidu 分别消耗 10/20/50 credits。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/search-visibility/llm.md

## 数据校验与使用边界

- 这些接口是基础可信检查，不替代漏洞扫描、渗透测试或安全审计。
- DNS、证书和 Whois 数据可能受传播和注册商更新时间影响。
- 可疑链接必须结合浏览器隔离、沙箱和人工安全流程复核。

## 输出建议

- 输出体检结果时按域名基础、证书解析、页面质量、链接和可见性分段。
- 对每个风险项给出域名、URL、查询时间和复核入口。
- 上线前检查建议给出通过、需修复、需人工确认三类状态。

## 常见问题

- 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
- 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
- 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问：域名可信与站点安全体检 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。