跨境内容本地化与号码校验 Skill
面向跨境内容本地化、多语言站点、国际号码校验和海外资料整理的公开 API 组合。
业务场景
用于跨境内容本地化、多语言站点、国际号码校验、国家地区展示、币种说明和海外资料整理。适合把翻译、语种检测、纠错、简繁转换、国际号码、国家地区、汇率、网页转 Markdown、文章抽取和隐私信息去除组合成跨境内容链路。
- 数据范围:覆盖多语言翻译、语种检测、多语言纠错、简繁转换、国际号码、国家地区、国际汇率、网页转 Markdown、文章结构化和隐私信息去除。
- 关键数据维度:语言维度:源语言、目标语言、语气、术语、简繁体和地区表达;市场维度:国家地区、国际号码、币种、汇率时间和本地格式;内容维度:URL、正文、标题、隐私字段和发布渠道。
何时使用
- 把中文或英文页面整理成目标市场可读的多语言版本。
- 校验国际号码、国家地区、币种和联系方式展示口径。
- 对跨境客服、商品资料、落地页和帮助文档做本地化处理。
不适用场景
- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时,直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时,不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时,Skill 只能提供数据辅助和复核线索。
用户需要提供的信息
- 源语言、目标语言、国家地区、页面 URL、营销文案、电话号码、展示币种和隐私处理要求。
- 输出目标:多语言页面、本地化文案、国际号码校验、国家地区展示或跨币种说明。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。
推荐工作流
- 先抽取或检测原文语言和页面正文。
- 再做翻译、纠错、简繁转换、国家地区和国际号码校验。
- 涉及价格或币种时结合汇率接口,并在对外发布前做隐私信息处理。
参数传递关系
- 先用语种检测确认原文语言,再把正文传给翻译、纠错和简繁转换接口。
- 国际号码接口用于校验和标准化联系方式,国家地区接口用于补齐国家、地区和展示名称。
- 页面 URL 可先转 Markdown 或抽取文章结构,再进入翻译和本地化处理。
- 价格、金额或金融内容展示时使用汇率接口,并标注币种和汇率时间。
- 对外发布前使用隐私信息去除接口处理个人联系方式或敏感字段。
典型任务模板
- 跨境落地页:输入中文 URL 和目标市场;输出 Markdown 正文、翻译稿、国家地区、号码校验和发布提醒。
- 客服文案本地化:输入原文、目标语言和地区;输出译文、语气修正、敏感信息检查和复核项。
- 商品资料整理:输入页面 URL、币种和联系方式;输出本地化摘要、汇率说明和号码格式。
接口与关键参数
统一鉴权:调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入,不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey;历史 Query 参数 appkey 仍以接口详情页说明为准。
多语言 AI 翻译
- 将文本翻译为指定语言,支持同步与流式返回
- 业务角色:多语言翻译
- 调用阶段:语言处理
- 接口地址:
POST https://api.gugudata.com/ai/multilingual-translation - 产出用途:用于生成目标语言内容。
- 参数来源:源语言和目标语言来自用户指定市场,必要时先用语种检测确认;文本内容来自用户输入、网页正文抽取或文档识别结果
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
language | 是 | string | - | 非空白目标语言名称或代码,兼容日语、日文、jp、japanese;必须显式传递,没有默认目标语言。 | 源语言和目标语言来自用户指定市场,必要时先用语种检测确认 |
content | 是 | string | - | 非空白原文,支持表单与历史 JSON。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
streaming | 否 | boolean | false | 默认 false;true 使用 SSE,片段 type=content/text,完整模型 JSON 文本 type=done/full_text,含 translated_content,最后 event=end/data=[DONE]。错误或不完整输出没有成功终态。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
NLP 语种检测
- 识别文本语种,返回候选语言与置信分数
- 业务角色:语种检测
- 调用阶段:语言处理
- 接口地址:
POST https://api.gugudata.com/text/detectlanguage - 产出用途:用于识别原文语言。
- 参数来源:文本内容来自用户输入、网页正文抽取或文档识别结果
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
content | 是 | string | 无 | 需要识别语种的非空白文本;支持文档表单和历史 JSON。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
多语言文本 AI 纠错格式化
- 校对语法、拼写与标点
- 业务角色:文本纠错
- 调用阶段:语言处理
- 接口地址:
POST https://api.gugudata.com/ai/grammar-correction - 产出用途:用于目标语言文本纠错。
- 参数来源:文本内容来自用户输入、网页正文抽取或文档识别结果
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
textContent | 是 | string | 无 | 需要校对的非空白文本。原文无需修改时也可正常返回;不增加语言或纠错力度选项。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
streaming | 否 | boolean | false | false 同步返回;true 沿用文本片段、done.full_text 和 event:end/[DONE] 的 SSE 格式。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
简体繁体互转
- 按指定方向转换简体与繁体中文
- 业务角色:简繁互转
- 调用阶段:语言处理
- 接口地址:
POST https://api.gugudata.com/text/stconvert - 产出用途:用于中文简繁体本地化。
- 参数来源:文本内容来自用户输入、网页正文抽取或文档识别结果
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
content | 是 | string | 无 | 需要转换的非空白字符串,支持表单和 JSON。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
from | 是 | string | 无 | s|t|thk|ttw,原始的内容类型,s: 简体 t: 繁体 thk: 香港繁体 ttw: 台湾繁体 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
to | 是 | string | 无 | s|t|thk|ttw,转换的目标类型,s: 简体 t: 繁体 thk: 香港繁体 ttw: 台湾繁体 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
国际手机号码检查纠正
- 检查国际手机号码格式,返回规范化号码及国家代码
- 业务角色:国际号码
- 调用阶段:号码校验
- 接口地址:
GET https://api.gugudata.com/sms/internationalphone - 产出用途:用于国际手机号码检查纠正。
- 参数来源:国际号码来自用户输入或落地页联系方式,先校验再展示;国家地区来自目标市场、国家地区接口或用户输入
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
phone | 是 | string | 无 | 待检查的号码字符串,支持现有国际格式;指定国家时也可传该国号码。 | 国际号码来自用户输入或落地页联系方式,先校验再展示 |
countrycode | 否 | string | 无 | 可选国家代码,支持现有两字母、三字母及大小写表达;不传时沿用国际号码解析规则。 | 国家地区来自目标市场、国家地区接口或用户输入 |
国家地区基础信息数据
- 查询国家及地区基础资料,支持多条件筛选
- 业务角色:国家地区
- 调用阶段:地区数据
- 接口地址:
GET https://api.gugudata.com/v2/location/country - 产出用途:用于查询国家地区基础信息。
- 参数来源:国际号码来自用户输入或落地页联系方式,先校验再展示;源语言和目标语言来自用户指定市场,必要时先用语种检测确认
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
code | 否 | string | 无 | 两位代码筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
phone | 否 | string | 无 | 电话区号筛选。 | 国际号码来自用户输入或落地页联系方式,先校验再展示 |
name | 否 | string | 无 | 名称筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
continent | 否 | string | 无 | 洲代码筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
currencies | 否 | string | 无 | 币种筛选,逗号分隔的同组值按任一匹配。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
languages | 否 | string | 无 | 语言筛选,逗号分隔的同组值按任一匹配。 | 源语言和目标语言来自用户指定市场,必要时先用语种检测确认 |
国际货币汇率
- 查询货币对汇率,支持最新公布数据与指定历史日期
- 业务角色:国际汇率
- 调用阶段:币种换算
- 接口地址:
GET https://api.gugudata.com/v2/finance/currency-exchange - 产出用途:用于跨币种展示。
- 参数来源:时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
source | 是 | string | - | 必填源币种代码,如 EUR、USD。忽略首尾空白并转大写,最多 20 个字符,允许字母、数字、$、.;是否支持以指定日期来源数据为准。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
date | 否 | string | latest | 默认 latest,空字符串同 latest;或 YYYY-MM-DD,如 2024-03-06。历史可用性以来源实际提供为准,历史结果必须匹配请求日期。 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |
target | 否 | string | - | 目标币种代码,如 CNY;不传或留空返回全部目标币种,代码规则与 source 相同。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
网页 URL 转 Markdown
- 公开网页转 Markdown
- 业务角色:网页转 Markdown
- 调用阶段:内容抽取
- 接口地址:
GET https://api.gugudata.com/websitetools/url2markdown - 产出用途:用于抽取网页正文。
- 参数来源:URL 或域名由用户提供,调用前需要确认协议、跳转和可访问性
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
url | 是 | string | - | 完整的公开 HTTP/HTTPS 网页地址;业务参数不可重复。登录、反爬或复杂动态页面可能无法转换。备用内容最多保存 7 天,可能较旧。 | URL 或域名由用户提供,调用前需要确认协议、跳转和可访问性 |
文章抽取信息化 JSON
- 网页文章正文与元数据一键提取
- 业务角色:文章结构化
- 调用阶段:内容抽取
- 接口地址:
POST https://api.gugudata.com/ai/v1/articles/extract - 产出用途:用于结构化提取文章内容。
- 参数来源:URL 或域名由用户提供,调用前需要确认协议、跳转和可访问性
- 可参考的相关能力:从 HTML 提取文章内容
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
url | 是 | string | N/A | 需要提取文章内容的网页 URL 地址 | URL 或域名由用户提供,调用前需要确认协议、跳转和可访问性 |
parserOptions | 否 | object | - | 可选;仅支持 wordsPerMinute、descriptionTruncateLen、descriptionLengthThreshold、contentLengthThreshold。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
fetchOptions | 否 | object | - | 可选;timeoutMs 为 1000-30000,仅允许 User-Agent、Accept、Accept-Language 请求头。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
个人可识别信息 (PII) 去除
- 文本个人信息识别与脱敏
- 业务角色:隐私信息去除
- 调用阶段:数据治理
- 接口地址:
POST https://api.gugudata.com/ai/pii-removal - 产出用途:用于对外发布前处理个人信息。
- 参数来源:文本内容来自用户输入、网页正文抽取或文档识别结果
- 查看接口详情 · 读取接口 Markdown
关键请求参数:
| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
|---|
content | 是 | string | - | 非空字符串,最多 4000 个 UTF-16 字符单元;保留空格和换行。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
streaming | 否 | boolean | false | 布尔值,默认 false;true 在处理完成后按流式协议接收脱敏文字和完整结果。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
失败处理与恢复
- 缺少必填输入或数据口径不明确时,停止调用并先向用户补齐信息。
- 收到 401 或 403 时,检查 AppKey、安全配置和服务权限;不要在输出中回显凭据。
- 收到 429 时,遵守接口返回的限流提示,降低频率后再试,不要并发放大请求。
- 遇到网络或 5xx 异常时,只对幂等请求进行有限次数重试,并记录失败接口与时间。
- 数据为空或多接口结果冲突时,返回已确认事实、证据缺口和复核建议,不要臆造结论。
数据校验与使用边界
- 翻译和本地化需要人工复核品牌术语、法律合规和文化语境。
- 汇率和号码校验结果有时效性,输出时标注查询时间。
- 隐私信息去除不能替代正式合规审计。
输出建议
- 输出本地化结果时包含源文、译文、术语、号码校验、国家地区和汇率说明。
- 对网页内容保留原 URL 和抽取时间。
- 对敏感字段标注已处理、待复核或不可判断。
常见问题
- 问:什么情况下应该使用这个 Skill? 答:当用户提出的目标需要多个咕咕数据公开 API 组合完成,而不是只查询一个接口时,优先阅读这个 Skill。
- 问:这个 Skill 是否需要单独购买? 答:不需要。Skill 文档只负责业务流程和接口选型,具体接口购买、价格和账号权益仍以接口详情页为准。
- 问:Agent 应该怎样使用这个 Skill? 答:Agent 应先阅读 SKILL.md,确认业务场景和推荐工作流,再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问:调用接口前需要先核对什么? 答:需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问:跨境内容本地化与号码校验 Skill 会替代接口文档吗? 答:不会。Skill 负责说明业务组合和调用顺序,接口参数、响应结构、计费和购买入口仍以接口详情页为准。