网站 SEO 与搜索可见性 Skill

面向网站 SEO、搜索引擎可见性、页面质量、站点快照和域名基础诊断的公开 API 组合。

业务场景

用于 SEO 巡检、搜索可见性监控、站点诊断、竞品页面分析和内容采集。适合把搜索可见性、页面性能、网页快照、正文抽取、链接提取、DNS、SSL、Whois 和 favicon 信息组合起来评估一个站点。

• 数据范围：覆盖搜索可见性观测、页面性能评分、URL 截图、HTML 快照、Markdown 转换、链接提取、正文抽取、语义 JSON、站点标题图标、DNS、SSL 证书和 Whois。
• 关键数据维度：页面维度：URL、标题、正文、HTML、Markdown、链接、截图和结构化内容。；搜索维度：可见性任务、观测结果、页面质量和收录相关信号。；站点维度：域名、DNS 记录、证书有效期、Whois 信息和 favicon。

何时使用

• 判断页面能否被搜索引擎理解和收录。
• 检查页面性能、HTML 快照、正文内容、链接结构和站点基础信息。
• 对竞品、专题页、落地页和内容页做批量质量诊断。

不适用场景

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

用户需要提供的信息

• 目标 URL、域名、页面列表、观察时间和希望检查的 SEO 问题。
• 是否需要页面截图、正文抽取、链接提取、性能诊断、DNS、SSL 或 Whois 信息。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 先建立搜索可见性报告并运行观测任务。
2. 再用页面性能、快照、链接、正文和 Markdown 抽取接口分析页面质量。
3. 最后用 DNS、SSL、Whois 和 favicon 接口补齐站点基础信息。

参数传递关系

• 目标 url 先用于页面快照、正文抽取、Markdown 转换和链接提取，再把域名部分传给 DNS、SSL、Whois 和 favicon 查询。
• 批量页面任务需要保留每个 URL 的抓取时间、HTTP 状态、标题、正文和链接结果，避免跨页面混用。
• 搜索可见性结果应和页面质量、站点基础信息分开解释。

典型任务模板

• 页面诊断：输入 URL；输出页面快照、正文、链接、性能和可见性问题。
• 站点基础检查：输入域名；输出 DNS、SSL、Whois、favicon 和基础风险提示。
• 竞品内容分析：输入多个 URL；输出标题、正文、链接和结构化内容对比。

接口与关键参数

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

搜索可见性 SERP 数据接口

• 业务角色：搜索可见性
• 调用阶段：搜索观测
• 接口地址：POST https://api.gugudata.com/v1/searchVisibilityReports
• 产出用途：用于创建和查询搜索可见性观测报告。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；地区参数来自用户输入、行政区划查询结果或定位结果
• 可参考的相关能力：获取搜索可见性报告、搜索可见性报告列表、创建搜索可见性观测任务、搜索可见性观测任务列表、获取搜索可见性观测任务
• 接口资料：详情页 https://www.gugudata.com/api/details/search-visibility；接口 Markdown https://www.gugudata.com/api/details/search-visibility/llm.md

关键请求参数：

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

网页性能与 SEO 评分

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

关键请求参数：

网站截图与 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 生成网站截图

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

关键请求参数：

URL 转静态 HTML 文件

• 业务角色：URL 转 HTML
• 调用阶段：页面采集
• 接口地址：POST https://api.gugudata.com/websitetools/url2html
• 产出用途：用于获取页面静态 HTML。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/url2html；接口 Markdown https://www.gugudata.com/api/details/url2html/llm.md

关键请求参数：

网页 URL 转 Markdown

• 业务角色：URL 转 Markdown
• 调用阶段：内容抽取
• 接口地址：GET https://api.gugudata.com/websitetools/url2markdown
• 产出用途：用于把网页内容转成 Markdown。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/url2markdown；接口 Markdown https://www.gugudata.com/api/details/url2markdown/llm.md

关键请求参数：

网页 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

关键请求参数：

网页可读内容抽取

• 业务角色：正文抽取
• 调用阶段：内容抽取
• 接口地址：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

关键请求参数：

语义化获取站点 JSON 结构内容

• 业务角色：语义化 JSON
• 调用阶段：内容抽取
• 接口地址：POST https://api.gugudata.com/websitetools/url2json
• 产出用途：用于把站点内容结构化为 JSON。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/url2json；接口 Markdown https://www.gugudata.com/api/details/url2json/llm.md

关键请求参数：

获取任意站点标题与图标

• 业务角色：标题与图标
• 调用阶段：站点信息
• 接口地址：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

关键请求参数：

域名 DNS 信息查询

• 业务角色：DNS 查询
• 调用阶段：站点信息
• 接口地址：GET https://api.gugudata.com/v2/websitetools/dns-lookup
• 产出用途：用于查询域名 DNS 信息。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/dnslookup；接口 Markdown https://www.gugudata.com/api/details/dnslookup/llm.md

关键请求参数：

域名 SSL 证书信息解析

• 业务角色：SSL 证书
• 调用阶段：站点信息
• 接口地址：GET https://api.gugudata.com/v2/websitetools/sslcertinfo
• 产出用途：用于解析域名 SSL 证书信息。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/sslcertinfo；接口 Markdown https://www.gugudata.com/api/details/sslcertinfo/llm.md

关键请求参数：

域名 Whois 查询

• 业务角色：Whois 查询
• 调用阶段：站点信息
• 接口地址：GET https://api.gugudata.com/v2/websitetools/whois
• 产出用途：用于查询域名 Whois 信息。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/whois；接口 Markdown https://www.gugudata.com/api/details/whois/llm.md

关键请求参数：

数据校验与使用边界

• 区分浏览器渲染结果和原始 HTML 抽取结果。
• 页面性能与搜索可见性需要结合搜索引擎后台和真实抓取状态复核。
• 域名、证书和 Whois 结果可能受 DNS 解析链路和注册商更新延迟影响。

输出建议

• 输出诊断报告时按页面质量、内容抽取、链接结构和站点基础信息分段。
• 对每个问题给出 URL、观测时间、涉及接口和下一步复核建议。
• 不要把未接入或无法判断的数据写成零值。

常见问题

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