---
name: cross-border-localization
description: "面向跨境内容本地化、多语言站点、国际号码校验和海外资料整理的公开 API 组合。适用于跨境内容本地化、国际号码校验、多语言站点。"
compatibility: "需要访问 GuGuData HTTPS API；执行接口前需开通对应服务并安全配置 AppKey。"
metadata:
  author: "GuGuData"
  version: "1.0.0"
  homepage: "https://www.gugudata.com/skills/cross-border-localization"
---

# 跨境内容本地化与号码校验 Skill

面向跨境内容本地化、多语言站点、国际号码校验和海外资料整理的公开 API 组合。

## 业务场景

用于跨境内容本地化、多语言站点、国际号码校验、国家地区展示、币种说明和海外资料整理。适合把翻译、语种检测、纠错、简繁转换、国际号码、国家地区、汇率、网页转 Markdown、文章抽取和隐私信息去除组合成跨境内容链路。

- 数据范围：覆盖多语言翻译、语种检测、多语言纠错、简繁转换、国际号码、国家地区、国际汇率、网页转 Markdown、文章结构化和隐私信息去除。
- 关键数据维度：语言维度：源语言、目标语言、语气、术语、简繁体和地区表达；市场维度：国家地区、国际号码、币种、汇率时间和本地格式；内容维度：URL、正文、标题、隐私字段和发布渠道。

## 何时使用

- 把中文或英文页面整理成目标市场可读的多语言版本。
- 校验国际号码、国家地区、币种和联系方式展示口径。
- 对跨境客服、商品资料、落地页和帮助文档做本地化处理。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

## 用户需要提供的信息

- 源语言、目标语言、国家地区、页面 URL、营销文案、电话号码、展示币种和隐私处理要求。
- 输出目标：多语言页面、本地化文案、国际号码校验、国家地区展示或跨币种说明。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先抽取或检测原文语言和页面正文。
2. 再做翻译、纠错、简繁转换、国家地区和国际号码校验。
3. 涉及价格或币种时结合汇率接口，并在对外发布前做隐私信息处理。

## 参数传递关系

- 先用语种检测确认原文语言，再把正文传给翻译、纠错和简繁转换接口。
- 国际号码接口用于校验和标准化联系方式，国家地区接口用于补齐国家、地区和展示名称。
- 页面 URL 可先转 Markdown 或抽取文章结构，再进入翻译和本地化处理。
- 价格、金额或金融内容展示时使用汇率接口，并标注币种和汇率时间。
- 对外发布前使用隐私信息去除接口处理个人联系方式或敏感字段。

## 典型任务模板

- 跨境落地页：输入中文 URL 和目标市场；输出 Markdown 正文、翻译稿、国家地区、号码校验和发布提醒。
- 客服文案本地化：输入原文、目标语言和地区；输出译文、语气修正、敏感信息检查和复核项。
- 商品资料整理：输入页面 URL、币种和联系方式；输出本地化摘要、汇率说明和号码格式。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 多语言 AI 翻译

- 将文本翻译为指定语言，支持同步与流式返回
- 业务角色：多语言翻译
- 调用阶段：语言处理
- 接口地址：`POST https://api.gugudata.com/ai/multilingual-translation`
- 产出用途：用于生成目标语言内容。
- 参数来源：源语言和目标语言来自用户指定市场，必要时先用语种检测确认；文本内容来自用户输入、网页正文抽取或文档识别结果
- [查看接口详情](https://www.gugudata.com/api/details/multilingual-translation) · [读取接口 Markdown](https://www.gugudata.com/api/details/multilingual-translation/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `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`
- 产出用途：用于识别原文语言。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- [查看接口详情](https://www.gugudata.com/api/details/nlpdetectlanguage) · [读取接口 Markdown](https://www.gugudata.com/api/details/nlpdetectlanguage/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `content` | 是 | `string` | 无 | 需要识别语种的非空白文本；支持文档表单和历史 JSON。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |

### 多语言文本 AI 纠错格式化

- 校对语法、拼写与标点
- 业务角色：文本纠错
- 调用阶段：语言处理
- 接口地址：`POST https://api.gugudata.com/ai/grammar-correction`
- 产出用途：用于目标语言文本纠错。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- [查看接口详情](https://www.gugudata.com/api/details/grammar-correction) · [读取接口 Markdown](https://www.gugudata.com/api/details/grammar-correction/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `textContent` | 是 | `string` | 无 | 需要校对的非空白文本。原文无需修改时也可正常返回；不增加语言或纠错力度选项。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `streaming` | 否 | `boolean` | false | false 同步返回；true 沿用文本片段、done.full_text 和 event:end/[DONE] 的 SSE 格式。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 简体繁体互转

- 按指定方向转换简体与繁体中文
- 业务角色：简繁互转
- 调用阶段：语言处理
- 接口地址：`POST https://api.gugudata.com/text/stconvert`
- 产出用途：用于中文简繁体本地化。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- [查看接口详情](https://www.gugudata.com/api/details/stconvert) · [读取接口 Markdown](https://www.gugudata.com/api/details/stconvert/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `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`
- 产出用途：用于国际手机号码检查纠正。
- 参数来源：国际号码来自用户输入或落地页联系方式，先校验再展示；国家地区来自目标市场、国家地区接口或用户输入
- [查看接口详情](https://www.gugudata.com/api/details/internationalphone) · [读取接口 Markdown](https://www.gugudata.com/api/details/internationalphone/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `phone` | 是 | `string` | 无 | 待检查的号码字符串，支持现有国际格式；指定国家时也可传该国号码。 | 国际号码来自用户输入或落地页联系方式，先校验再展示 |
| `countrycode` | 否 | `string` | 无 | 可选国家代码，支持现有两字母、三字母及大小写表达；不传时沿用国际号码解析规则。 | 国家地区来自目标市场、国家地区接口或用户输入 |

### 国家地区基础信息数据

- 查询国家及地区基础资料，支持多条件筛选
- 业务角色：国家地区
- 调用阶段：地区数据
- 接口地址：`GET https://api.gugudata.com/v2/location/country`
- 产出用途：用于查询国家地区基础信息。
- 参数来源：国际号码来自用户输入或落地页联系方式，先校验再展示；源语言和目标语言来自用户指定市场，必要时先用语种检测确认
- [查看接口详情](https://www.gugudata.com/api/details/metacountry) · [读取接口 Markdown](https://www.gugudata.com/api/details/metacountry/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `code` | 否 | `string` | 无 | 两位代码筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `phone` | 否 | `string` | 无 | 电话区号筛选。 | 国际号码来自用户输入或落地页联系方式，先校验再展示 |
| `name` | 否 | `string` | 无 | 名称筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `continent` | 否 | `string` | 无 | 洲代码筛选。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `currencies` | 否 | `string` | 无 | 币种筛选，逗号分隔的同组值按任一匹配。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `languages` | 否 | `string` | 无 | 语言筛选，逗号分隔的同组值按任一匹配。 | 源语言和目标语言来自用户指定市场，必要时先用语种检测确认 |

### 国际货币汇率

- 查询货币对汇率，支持最新公布数据与指定历史日期
- 业务角色：国际汇率
- 调用阶段：币种换算
- 接口地址：`GET https://api.gugudata.com/v2/finance/currency-exchange`
- 产出用途：用于跨币种展示。
- 参数来源：时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
- [查看接口详情](https://www.gugudata.com/api/details/currencyexchange) · [读取接口 Markdown](https://www.gugudata.com/api/details/currencyexchange/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `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 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- [查看接口详情](https://www.gugudata.com/api/details/url2markdown) · [读取接口 Markdown](https://www.gugudata.com/api/details/url2markdown/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | - | 完整的公开 HTTP/HTTPS 网页地址；业务参数不可重复。登录、反爬或复杂动态页面可能无法转换。备用内容最多保存 7 天，可能较旧。 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |

### 文章抽取信息化 JSON

- 网页文章正文与元数据一键提取
- 业务角色：文章结构化
- 调用阶段：内容抽取
- 接口地址：`POST https://api.gugudata.com/ai/v1/articles/extract`
- 产出用途：用于结构化提取文章内容。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 可参考的相关能力：从 HTML 提取文章内容
- [查看接口详情](https://www.gugudata.com/api/details/article-extract) · [读取接口 Markdown](https://www.gugudata.com/api/details/article-extract/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `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`
- 产出用途：用于对外发布前处理个人信息。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- [查看接口详情](https://www.gugudata.com/api/details/pii-removal) · [读取接口 Markdown](https://www.gugudata.com/api/details/pii-removal/llm.md)

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `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 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。

