---
name: news-content-general-tools
description: "当用户需要使用咕咕数据公开 API 完成内容聚合、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
compatibility: "需要访问 GuGuData HTTPS API；执行接口前需开通对应服务并安全配置 AppKey。"
metadata:
  author: "GuGuData"
  version: "1.0.0"
  homepage: "https://www.gugudata.com/skills/news-content-general-tools"
---

# 资讯内容与通用数据工具 Skill

面向文章正文、公众号封面、内容图片、笑话、ISBN、号码归属和通用工具的公开 API 组合。

## 业务场景

用于资讯内容整理、文章正文抽取、公众号封面、笑话内容、ISBN、号码归属地、国际号码和轻量通用工具。适合运营后台、内容聚合、资料整理和客服辅助查询。

- 数据范围：覆盖新闻资讯、文章正文、公众号封面、笑话、ISBN、手机归属地、国际号码、二维码和排版整理等通用数据。
- 关键数据维度：内容维度：标题、正文、来源 URL、封面、发布时间和可读文本。；资料维度：ISBN、号码、归属地、国家地区和校验结果。；工具维度：二维码、格式化、轻量查询和运营辅助。

## 何时使用

- 从 URL 或公众号文章中提取正文、封面和可整理内容。
- 查询 ISBN、手机归属地、国际号码和轻量资料信息。
- 为运营工具、内容库、客服系统和日常查询提供辅助能力。

## 不适用场景

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

## 用户需要提供的信息

- 文章 URL、公众号链接、ISBN、号码、文本或轻量查询对象。
- 输出目标：正文抽取、封面获取、归属地查询、内容整理或运营辅助。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先按来源 URL 抽取正文、图片或封面。
2. 再用文本、ISBN、号码等工具补充结构化信息。
3. 需要发布或分享时，结合二维码、截图和文本处理接口。

## 参数传递关系

- 文章 URL 先用于正文、封面或内容抽取，再把正文传给摘要、关键词或排版整理。
- 号码、ISBN 和国际号码查询使用用户输入作为主键，结果只作为辅助资料。
- 内容抽取结果需要保留来源 URL，避免把第三方内容当作版权授权。

## 典型任务模板

- 文章抽取：输入 URL；输出标题、正文、封面、摘要和来源。
- 号码查询：输入手机号或国际号码；输出归属地、国家地区和使用边界。
- 资料查询：输入 ISBN 或轻量查询对象；输出结构化资料和复核提示。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 获取任意链接文章正文

- 业务角色：文章正文
- 调用阶段：内容抽取
- 接口地址：`POST https://api.gugudata.com/news/fetchcontent`
- 产出用途：用于获取任意链接文章正文。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文本内容来自用户输入、网页正文抽取或文档识别结果
- 接口资料：详情页 https://www.gugudata.com/api/details/fetchcontent；接口 Markdown https://www.gugudata.com/api/details/fetchcontent/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 需要抓取正文的文章链接 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `contentwithhtml` | 否 | `boolean` | false | 返回的文章是否包含 HTML 标签 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `htmlsourcecontent` | 否 | `boolean` | false | 是否返回文章页面原始 HTML 内容，供您二次解析或分析正文失败时使用，需要注意接口的性能问题 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |

### 获取任意链接正文图片

- 业务角色：正文图片
- 调用阶段：内容抽取
- 接口地址：`POST https://api.gugudata.com/news/fetchcontentimages`
- 产出用途：用于获取任意链接正文图片。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文件或图片来自用户上传、公开 URL 或上一轮转换结果；文本内容来自用户输入、网页正文抽取或文档识别结果
- 接口资料：详情页 https://www.gugudata.com/api/details/fetchcontentimages；接口 Markdown https://www.gugudata.com/api/details/fetchcontentimages/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 公开 HTTP/HTTPS 文章链接，必须显式传入；支持表单和 JSON，不保证识别全部网页图片。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `limittype` | 否 | `string` | - | 不传时不筛选；size 按最小文件大小筛选，ratio 按最小宽、高筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `limitvalue` | 否 | `float / [int,int]` | - | 指定筛选类型时必填：size 为非负 KB 数值，支持小数；ratio 为 [宽,高]，两个非负整数，单位为像素。未指定类型时忽略此值。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `imagewithtag` | 否 | `boolean` | false | 是否返回与图片 URL 对应的完整 img 标签，默认 false。 | 文件或图片来自用户上传、公开 URL 或上一轮转换结果 |
| `htmlsourcecontent` | 否 | `boolean` | false | 是否返回页面原始 HTML，默认 false。15 分钟主已保存结果及最多 24 小时备用内容可能与网页当前状态不同。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |

### 获取公众号文章封面

- 业务角色：公众号封面
- 调用阶段：内容抽取
- 接口地址：`GET https://api.gugudata.com/news/wxarticlecover`
- 产出用途：用于获取公众号文章封面。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口资料：详情页 https://www.gugudata.com/api/details/wxarticlecover；接口 Markdown https://www.gugudata.com/api/details/wxarticlecover/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 微信公众号文章 URL，需要传入完整链接。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |

### 幽默笑话大全

- 业务角色：笑话内容
- 调用阶段：内容数据
- 接口地址：`GET https://api.gugudata.com/news/joke`
- 产出用途：用于查询幽默笑话大全。
- 参数来源：分页参数由调用方控制，用于分批读取结果
- 接口资料：详情页 https://www.gugudata.com/api/details/joke；接口 Markdown https://www.gugudata.com/api/details/joke/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | - | 笑话分类，支持类型：'所有','经典','名著暴笑','爆笑男女','哈哈趣闻','原创','恐怖','爱情','校园','幽默','儿童','爆笑','综合','动物','顺口溜','搞笑歌词','恋爱必读','英语','短信','求爱秘籍','极品','数学','一句话','短笑话','小笑话','内涵','冷笑话','重口味','整人','各地方言','短篇','搞笑','简短','超级','数码' | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `pageindex` | 否 | `integer` | 1 | 页码 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 否 | `integer` | 10 | 每页数据量，参数最大值为 100 | 分页参数由调用方控制，用于分批读取结果 |

### 国际标准书号 ISBN

- 业务角色：ISBN 查询
- 调用阶段：资料查询
- 接口地址：`GET https://api.gugudata.com/text/isbn`
- 产出用途：用于国际标准书号 ISBN 查询。
- 参数来源：关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
- 接口资料：详情页 https://www.gugudata.com/api/details/isbn；接口 Markdown https://www.gugudata.com/api/details/isbn/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `keywords` | 否 | `string` | YOUR_VALUE | 图书标题搜索关键字；与 isbn 参数至少传递一个 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `pageindex` | 否 | `integer` | 1 | 搜索结果分页参数，第几页 | 分页参数由调用方控制，用于分批读取结果 |
| `pagesize` | 否 | `integer` | 10 | 搜索结果分页参数，每页条数，最大值为 10 | 分页参数由调用方控制，用于分批读取结果 |
| `isbn` | 否 | `string` | YOUR_VALUE | 图书 ISBN；与 keywords 参数至少传递一个，如 9787020002320 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 手机归属地查询

- 业务角色：手机归属地
- 调用阶段：号码工具
- 接口地址：`GET https://api.gugudata.com/sms/mobileattribution`
- 产出用途：用于手机归属地查询。
- 参数来源：号码来自用户输入、表单线索或上一轮内容抽取结果
- 接口资料：详情页 https://www.gugudata.com/api/details/mobileattribution；接口 Markdown https://www.gugudata.com/api/details/mobileattribution/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `mobile` | 是 | `string` | - | 查询的手机号码 | 号码来自用户输入、表单线索或上一轮内容抽取结果 |

### 国际手机号码检查纠正

- 业务角色：国际号码
- 调用阶段：号码工具
- 接口地址：`GET https://api.gugudata.com/sms/internationalphone`
- 产出用途：用于国际手机号码检查纠正。
- 参数来源：号码来自用户输入、表单线索或上一轮内容抽取结果；国家地区来自用户输入、国家地区接口或业务目标市场
- 接口资料：详情页 https://www.gugudata.com/api/details/internationalphone；接口 Markdown https://www.gugudata.com/api/details/internationalphone/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `phone` | 是 | `string` | - | 查询的手机号码，如 +1(817) 569-8900 | 号码来自用户输入、表单线索或上一轮内容抽取结果 |
| `countrycode` | 否 | `string` | COUNTRY_CODE | ISO-3166 标准的两位或三位国家代码，用于校验号码在提供的归属国家是否为有效号码，如 US, USA，不传递则智能纠错 | 国家地区来自用户输入、国家地区接口或业务目标市场 |

### 通用二维码生成

- 业务角色：二维码生成
- 调用阶段：分享工具
- 接口地址：`GET https://api.gugudata.com/barcode/qrcode`
- 产出用途：用于内容分享二维码生成。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- 接口资料：详情页 https://www.gugudata.com/api/details/qrcode；接口 Markdown https://www.gugudata.com/api/details/qrcode/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `content` | 是 | `string` | - | 二维码内容，网址类型智能识别 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `size` | 否 | `integer` | 500 | 正整数，二维码尺寸像素，默认为 500 像素 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 网页 URL 转 Markdown

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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 完整的公开 HTTP/HTTPS 网页地址；业务参数不可重复。登录、反爬或复杂动态页面可能无法转换。备用内容最多保存 7 天，可能较旧。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |

### NLP 中英文排版规范化

- 业务角色：排版规范化
- 调用阶段：内容整理
- 接口地址：`POST https://api.gugudata.com/text/formatarticle`
- 产出用途：用于中英文排版规范化。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- 接口资料：详情页 https://www.gugudata.com/api/details/formatarticle；接口 Markdown https://www.gugudata.com/api/details/formatarticle/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `content` | 是 | `string` | - | 非空白字符串正文，支持表单和 JSON；保留当前排版规则。复杂结构文本需核对结果。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |

## 失败处理与恢复

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

## 数据校验与使用边界

- 内容抽取结果受原站结构、反爬、版权和页面变更影响。
- 号码、ISBN 等轻量查询应作为辅助信息，关键业务要复核。
- 不要把第三方内容抽取结果当作版权授权。

## 输出建议

- 输出内容类结果时保留来源 URL、标题、摘要和封面信息。
- 输出号码或 ISBN 查询时说明查询字段和归属结果。
- 运营工具场景建议返回可直接展示的短文本和复核提示。

## 常见问题

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