名称： countries
版本： 1.0.0
描述： "为 AI 智能体提供的国家信息查询 CLI 工具，供其服务的人类用户使用。基于 REST Countries API，无需认证。"
主页： https://restcountries.com
元数据：
openclaw:
emoji: "🌍"
requires:
bins: ["bash", "curl", "jq", "bc"]
tags: ["countries", "geography", "reference", "api", "cli"]

国家信息查询

为 AI 智能体提供的 CLI 工具，用于为其服务的人类用户查询国家信息。例如，“蒙古的首都是哪里？”——现在你的智能体可以回答了。

基于 REST Countries API (v3.1)。无需账户或 API 密钥。

使用方式

"告诉我关于日本的信息"
"南美洲有哪些国家？"
"哪个国家的首都是东京？"
"查询国家代码 DE 的信息"

命令

示例

countries search "united states"   # 按名称查找国家
countries info US                  # 通过 alpha-2 代码获取完整详情
countries info USA                 # 也支持 alpha-3 代码
countries region europe            # 所有欧洲国家
countries capital tokyo            # 按首都查找国家
countries all                      # 列出所有国家（已排序）

区域

有效区域：africa, americas, asia, europe, oceania

输出格式

搜索/列表输出：

[US] United States — Washington D.C., Americas, Pop: 331M, 🇺🇸

详细信息输出：

🌍 日本
   官方名称：Japan
   代码：JP / JPN / 392
   首都：Tokyo
   区域：Asia — Eastern Asia
   人口：125.8M
   面积：377930 km²
   语言：Japanese
   货币：Japanese yen (JPY)
   时区：UTC+09:00
   接壤国家：None (island/isolated)
   驾驶侧：left side
   国旗：🇯🇵

🗺️ 地图：https://goo.gl/maps/...

注意事项

• 使用 REST Countries API v3.1 (restcountries.com)
• 无需认证，无速率限制
• 国家代码支持：alpha-2 (US)、alpha-3 (USA) 或数字代码 (840)
• 人口数字格式化为带 K/M/B 后缀
• 所有区域名称使用小写

智能体实现说明

脚本位置： {skill_folder}/countries（包装至 scripts/countries）

当用户询问国家信息时：
1. 运行 ./countries search "名称" 查找国家代码
2. 运行 ./countries info <代码> 获取完整详情
3. 运行 ./countries region <区域> 获取区域国家列表
4. 运行 ./countries capital "城市" 按首都查找国家

常见查询模式：
- “X 在哪个国家？” → 按名称搜索
- “告诉我关于 X 的信息” → 先搜索，再用代码获取详情
- “欧洲有哪些国家？” → 使用 region europe
- “X 的首都是什么？” → 用代码获取详情，查看 capital 字段
- “哪个国家的首都是 X？” → 使用首都搜索

不适用于： 历史国家、争议领土、非主权地区。