Swiss Phone Directory Skill

Search the Swiss phone directory (search.ch) for businesses, people, and phone numbers.

Quick Start

# Search for a business
python3 scripts/searchch.py search "Migros" --location "Zürich"

# Search for a person
python3 scripts/searchch.py search "Müller Hans" --type person

# Reverse phone number lookup
python3 scripts/searchch.py search "+41442345678"

# Business-only search
python3 scripts/searchch.py search "Restaurant" --location "Bern" --type business --limit 5

Commands

search

Search for businesses, people, or phone numbers.

python3 scripts/searchch.py search <query> [options]

Options:
  --location, -l    City, ZIP, street, or canton (e.g., "Zürich", "8000", "ZH")
  --type, -t        Filter: "business", "person", or "all" (default: all)
  --limit, -n       Max results (default: 10, max: 200)
  --lang            Output language: de, fr, it, en (default: de)

Examples

# Find restaurants in Rapperswil
python3 scripts/searchch.py search "Restaurant" -l "Rupperswil" -t business -n 5

# Find a person by name
python3 scripts/searchch.py search "Meier Peter" -l "Zürich" -t person

# Reverse lookup a phone number
python3 scripts/searchch.py search "044 123 45 67"

# Search with canton abbreviation
python3 scripts/searchch.py search "Bäckerei" -l "SG"

Output Format

Results include (when available):

• Name - Business or person name


• Type - Organisation or Person


• Address - Street, ZIP, city, canton


• Phone - Phone number(s)


• Fax - Fax number


• Email - Email address


• Website - Website URL


• Categories - Business categories

Configuration

See references/configuration.md for setup.

Required: SEARCHCH_API_KEY environment variable.

API Reference

• Base URL: `
• Rate limits: Depend on API key tier
• Full docs: