国家信息查询

技能简介

countries 是一款面向 AI 代理的 CLI 工具，用于快速查询全球国家/地区的基础信息。通过调用 REST Countries API v3.1，无需注册账号或申请 API 密钥即可获取首都、人口、货币、时区、边界等数据。

业务背景

跨国业务团队需要快速获取国家基础信息时，无需注册复杂平台即可查询首都、货币、时区等关键数据。适用于客服答疑、合同起草、物流规划等场景，帮助员工即时确认国家代码、边界关系等细节，减少对外部百科的依赖，提升信息获取效率。

落地案例：某外贸公司处理中东订单时，业务员通过工具输入"UAE"快速确认阿联酋的Alpha-3代码为ARE，获取官方货币为阿联酋迪拉姆（AED），并核实其标准时区为UTC+4。该信息直接用于报关单据填写，避免因国别信息错误导致的清关延误。

能做什么

• 按名称模糊搜索国家，返回代码与概要
• 用 Alpha-2/Alpha-3/数字代码查询完整详情
• 按大洲（非洲、美洲、亚洲、欧洲、大洋洲）列出所有国家
• 根据首都城市反查所属国家
• 输出格式化的人口、面积、语言、货币、驾驶方向等信息

使用说明

安装依赖

# 确保系统已安装以下二进制工具
bash curl jq bc

部署步骤

1. 将技能文件下载至 {skill_folder}/countries 目录
2. 赋予执行权限：chmod +x countries
3. 验证环境：./countries all | head -5

常用命令

./countries search "japan"      # 名称搜索
./countries info JP             # 代码查详情
./countries region asia         # 亚洲国家列表
./countries capital "tokyo"     # 首都反查
./countries all                 # 全部国家列表

输入与输出

见下方输入与输出表格。

风险提示

• API 为公开服务，无 SLA 保障，存在不可用风险
• 不包含历史国家、争议领土、非主权地区数据
• 人口数据为估算值，可能存在更新延迟
• 网络不通时无法获取任何结果

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jeffaf/countries/SKILL.md
来源类型：开源社区技能