🌍 geo-countries-infos

A TypeScript utility for scraping and querying detailed information about countries, including ISO codes, capitals, currencies, languages, EU/Schengen membership, and more.

• 🔎 Scrapes data from geonames.org
• 🌐 Supports filtering by continent, currency, language, EU & Schengen
• 💾 Saves country data as countries.json
• 💡 Provides an easy-to-use CountryRepository class

---

Installation

npm install geo-countries-infos

---

Scraping Country Data

The package includes a scraper that fetches country data from geonames.org and writes it to a local countries.json file.

Example

import { CountryScraper } from 'geo-countries-infos';

const scraper = new CountryScraper();

scraper.fetchCountries().then(countries => {
  console.log(`${countries.length} countries scraped successfully.`);
}).catch(console.error);

This generates a file countries.json in the root directory containing an array of country objects.

---

Using CountryRepository

After generating or loading the country data, you can use the CountryRepository to easily query it.

Example

import { readFileSync } from "fs";
import { CountryRepository } from 'geo-countries-infos';
import { Country } from 'geo-countries-infos/types/Country';

const rawData = readFileSync("countries.json", "utf-8");
const countries: Country[] = JSON.parse(rawData);
const repo = new CountryRepository(countries);

console.log(repo.getCountry("DE")); // Germany
console.log(repo.getEUCountries().map(c => c.name));
console.log(repo.getCountriesByCurrency("Euro (EUR)"));

---

API

CountryRepository

new CountryRepository(countries: Country[])

Methods

• getCountries(): Country[] — All countries
• getCountry(code: string): Country | undefined — By ISO Alpha-2 or Alpha-3
• getEUCountries(): Country[]
• getSchengenCountries(): Country[]
• getCountriesByCurrency(currency: string): Country[]
• getCountriesByLanguage(language: string): Country[]
• getCountriesByContinent(continent: string): Country[] — E.g., "EU", "AS", "AF"

---

Testing Locally

To test your local scrape and query logic:

// testRepository.ts
import { readFileSync } from "fs";
import { CountryRepository } from './src/repositories/CountryRepository'; // adjust path as needed

const data = JSON.parse(readFileSync("countries.json", "utf-8"));
const repo = new CountryRepository(data);

console.log("EU countries:", repo.getEUCountries().length);

Run with:

npx ts-node testRepository.ts

---

📄 License

MIT

---

🙌 Acknowledgements

• Data sourced from geonames.org