Introduction
# Swiss Phone Directory Skill
Search the Swiss phone directory (search.ch) for businesses, people, and phone numbers.
## Quick Start
```bash # 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.
```bash 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
```bash # 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** - Clickable tel: link (e.g., `[044 123 45 67](tel:+41441234567)`) - **Fax** - Clickable tel: link - **Email** - Email address - **Website** - Website URL - **Categories** - Business categories
### Clickable Phone Numbers 📞
Phone numbers are automatically formatted as Markdown links with `tel:` protocol: ``` 📞 [044 123 45 67](tel:+41441234567) ```
This enables **one-tap calling** on mobile devices (Telegram, Signal, WhatsApp, etc.).
To disable clickable links, use `--no-clickable`.
## Configuration
### Get an API Key (free)
1. **Request a key:** https://search.ch/tel/api/getkey.en.html 2. Fill out the form (name, email, use case) 3. **Approval:** ~10-15 minutes, key arrives via email
### Set the Environment Variable
```bash export SEARCHCH_API_KEY="your-api-key-here" ```
For permanent setup, see [references/configuration.md](references/configuration.md).
## API Reference
- Base URL: `https://search.ch/tel/api/` - Rate limits: Depend on API key tier - Full docs: https://search.ch/tel/api/help.en.html