网站 SEO 与搜索可见性 Skill 查看原始 SKILL.md

网站 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。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 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

关键请求参数：

参数必填类型默认值说明来源与传递
domain是string-需要观测的主域名，长度 1-255。可传 gugudata.com 或 https://www.gugudata.com，系统会按主域名规范化。URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
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否integer20观测排名深度，仅支持 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

网页性能与 SEO 评分

关键请求参数：

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

网站截图与 HTML 快照

关键请求参数：

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

URL 生成网站截图

关键请求参数：

参数必填类型默认值说明来源与传递
url是stringYOUR_VALUE需要截取的网页 URL 地址URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
width否integer250输出截图的宽度，默认值为 250由用户输入、业务筛选条件或上一轮接口结果确定。
height否integer250输出截图的高度，默认值为 250由用户输入、业务筛选条件或上一轮接口结果确定。
viewportWidth否integer1080渲染视窗的宽度，默认值为 1080由用户输入、业务筛选条件或上一轮接口结果确定。
viewportHeight否integer1080渲染视窗的高度，默认值为 1080由用户输入、业务筛选条件或上一轮接口结果确定。
forceReload否booleanfalse强制重新加载已保存的图片，默认值为 false由用户输入、业务筛选条件或上一轮接口结果确定。
isMobile否booleanfalse是否以移动设备的 User Agent 渲染，默认值为 false号码来自用户输入、表单线索或上一轮内容抽取结果
isFullPage否booleanfalse是否截取整个页面而非视窗裁剪，默认值为 false由用户输入、业务筛选条件或上一轮接口结果确定。
isDarkMode否booleanfalse是否优先采用深色模式，默认值为 false由用户输入、业务筛选条件或上一轮接口结果确定。

URL 转静态 HTML 文件

关键请求参数：

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

网页 URL 转 Markdown

关键请求参数：

参数必填类型默认值说明来源与传递
url是stringhttps://www.example.com需要转换的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性

网页 URL 链接提取

关键请求参数：

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

网页可读内容抽取

关键请求参数：

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

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

关键请求参数：

参数必填类型默认值说明来源与传递
url是stringhttps://www.example.com需要提取数据的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
prompt是string获取所有产品信息AI 提取指令，描述需要从网页中提取什么数据，例如：获取所有产品信息、提取文章标题和摘要等由用户输入、业务筛选条件或上一轮接口结果确定。

获取任意站点标题与图标

关键请求参数：

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

域名 DNS 信息查询

关键请求参数：

参数必填类型默认值说明来源与传递
domain是stringYOUR_VALUE需要解析的域名，格式为 gugudata.comURL 或域名由用户提供，调用前需要确认协议、跳转和可访问性

域名 SSL 证书信息解析

关键请求参数：

参数必填类型默认值说明来源与传递
domain是stringYOUR_VALUE需要解析的域名，格式为 https://www.gugudata.comURL 或域名由用户提供，调用前需要确认协议、跳转和可访问性

域名 Whois 查询

关键请求参数：

参数必填类型默认值说明来源与传递
domain是stringgugudata.com需要查询的域名，不需要带 http 或 https 协议。URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性

失败处理与恢复

  • 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
  • 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
  • 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
  • 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
  • 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

数据校验与使用边界

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

输出建议

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

常见问题

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

公司

条款

商业 API

更多分类

文档

在线调试

平台

接入与支持

Copyright © 2015-2026 江苏满数数据科技有限公司. All rights reserved. 苏ICP备2022035649号