Countries Lookup
CLI for AI agents to lookup country info for their humans. "What's the capital of Mongolia?" — now your agent can answer.
Uses REST Countries API (v3.1). No account or API key needed.
Usage
CODEBLOCK0
Commands
| Action | Command |
|---|
| Search by name | INLINECODE0 |
| Get details |
countries info <code> |
| List by region |
countries region <region> |
| Search by capital |
countries capital "city" |
| List all |
countries all |
Examples
CODEBLOCK1
Regions
Valid regions: africa, americas, asia, europe, INLINECODE9
Output
Search/list output:
CODEBLOCK2
Info output:
CODEBLOCK3
Notes
- - Uses REST Countries API v3.1 (restcountries.com)
- No authentication or rate limits
- Country codes: alpha-2 (US), alpha-3 (USA), or numeric (840)
- Population formatted with K/M/B suffixes
- All regions lowercase
Agent Implementation Notes
Script location: {skill_folder}/countries (wrapper to scripts/countries)
When user asks about countries:
- 1. Run
./countries search "name" to find country code - Run
./countries info <code> for full details - Run
./countries region <region> for regional lists - Run
./countries capital "city" to find by capital
Common patterns:
- - "What country is X in?" → search by name
- "Tell me about X" → search, then info with code
- "Countries in Europe" → region europe
- "Capital of X" → info with code, check capital field
- "What country has capital X?" → capital search
Don't use for: Historical countries, disputed territories, non-sovereign regions.
国家查询
供AI代理查询国家信息以帮助其人类用户的命令行工具。蒙古的首都是什么？——现在你的代理可以回答了。
使用REST Countries API（v3.1）。无需账户或API密钥。
使用方法
给我讲讲日本
南美洲有哪些国家？
哪个国家以东京为首都？
查询国家代码DE的信息
命令
| 操作 | 命令 |
|---|
| 按名称搜索 | countries search 查询词 |
| 获取详细信息 |
countries info <代码> |
| 按地区列出 | countries region <地区> |
| 按首都搜索 | countries capital 城市 |
| 列出所有 | countries all |
示例
bash
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] 美国 — 华盛顿特区，美洲，人口：3.31亿，🇺🇸
信息输出：
🌍 日本
官方名称：日本
代码：JP / JPN / 392
首都：东京
地区：亚洲 — 东亚
人口：1.258亿
面积：377930 km²
语言：日语
货币：日元（JPY）
时区：UTC+09:00
接壤国家：无（岛屿/孤立国家）
行驶方向：靠左行驶
国旗：🇯🇵
🗺️ 地图：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 名称 查找国家代码
- 运行 ./countries info <代码> 获取完整信息
- 运行 ./countries region <地区> 获取地区列表
- 运行 ./countries capital 城市 按首都查找
常见模式：
- - X在哪个国家？ → 按名称搜索
- 给我讲讲X → 搜索，然后用代码获取信息
- 欧洲的国家 → region europe
- X的首都 → 用代码获取信息，查看首都字段
- 哪个国家的首都是X？ → 按首都搜索
不适用于： 历史国家、争议领土、非主权地区。
