Countries
CLI for AI agents to lookup country info for their humans.
- Rating
- 3.9 (480 reviews)
- Downloads
- 39,299 downloads
- Version
- 1.0.0
Overview
CLI for AI agents to lookup country info for their humans.
Complete Documentation
View Source →
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
"Tell me about Japan"
"What countries are in South America?"
"Which country has Tokyo as capital?"
"Info on country code DE"
Commands
| Action | Command |
|---|---|
| Search by name | countries search "query" |
| Get details | countries info |
| List by region | countries region |
| Search by capital | countries capital "city" |
| List all | countries all |
Examples
countries search "united states" # Find country by name
countries info US # Get full details by alpha-2 code
countries info USA # Also works with alpha-3
countries region europe # All European countries
countries capital tokyo # Find country by capital
countries all # List all countries (sorted)
Regions
Valid regions: africa, americas, asia, europe, oceania
Output
Search/list output:
[US] United States — Washington D.C., Americas, Pop: 331M, 🇺🇸
Info output:
🌍 Japan
Official: Japan
Code: JP / JPN / 392
Capital: Tokyo
Region: Asia — Eastern Asia
Population: 125.8M
Area: 377930 km²
Languages: Japanese
Currencies: Japanese yen (JPY)
Timezones: UTC+09:00
Borders: None (island/isolated)
Driving: left side
Flag: 🇯🇵
🗺️ Map: https://goo.gl/maps/...
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:
- Run
./countries search "name"to find country code - Run
./countries infofor full details - Run
./countries regionfor regional lists - Run
./countries capital "city"to find by capital
- "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
Installation
openclaw install countries
💻Code Examples
"Info on country code DE"
## Commands
| Action | Command |
|--------|---------|
| Search by name | `countries search "query"` |
| Get details | `countries info <code>` |
| List by region | `countries region <region>` |
| Search by capital | `countries capital "city"` |
| List all | `countries all` |
### Examplescountries all # List all countries (sorted)
### Regions
Valid regions: `africa`, `americas`, `asia`, `europe`, `oceania`
## Output
**Search/list output:**"Tell me about Japan"
"What countries are in South America?"
"Which country has Tokyo as capital?"
"Info on country code DE"countries search "united states" # Find country by name
countries info US # Get full details by alpha-2 code
countries info USA # Also works with alpha-3
countries region europe # All European countries
countries capital tokyo # Find country by capital
countries all # List all countries (sorted)🌍 Japan
Official: Japan
Code: JP / JPN / 392
Capital: Tokyo
Region: Asia — Eastern Asia
Population: 125.8M
Area: 377930 km²
Languages: Japanese
Currencies: Japanese yen (JPY)
Timezones: UTC+09:00
Borders: None (island/isolated)
Driving: left side
Flag: 🇯🇵
🗺️ Map: https://goo.gl/maps/...Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
Adversarial Prompting
Adversarial analysis to critique, fix.