✓ Verified 📡 Monitoring ✓ Enhanced Data

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

text
"Tell me about Japan"
"What countries are in South America?"
"Which country has Tokyo as capital?"
"Info on country code DE"

Commands

ActionCommand
Search by namecountries search "query"
Get detailscountries info
List by regioncountries region
Search by capitalcountries capital "city"
List allcountries all

Examples

bash
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:

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

Info output:

text
🌍 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 info for full details
  • Run ./countries 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.

Installation

Terminal bash

openclaw install countries
    
Copied!

💻Code Examples

"Info on country code DE"

info-on-country-code-de.txt
## 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` |

### Examples

countries all # List all countries (sorted)

countries-all--list-all-countries-sorted.txt
### Regions

Valid regions: `africa`, `americas`, `asia`, `europe`, `oceania`

## Output

**Search/list output:**
example.txt
"Tell me about Japan"
"What countries are in South America?"
"Which country has Tokyo as capital?"
"Info on country code DE"
example.sh
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)
example.txt
🌍 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

#security_and-passwords #cli

Quick Info

Category Monitoring
Model Claude 3.5
Complexity Multi-Agent
Author jeffaf
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install countries