How do I install the Swiss Phone Directory skill?

Run npx skillmds@latest add dvcrn/swiss-phone-directory in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Swiss Phone Directory safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Swiss Phone Directory?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Swiss Phone Directory free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Swiss Phone Directory?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Swiss Phone Directory by dvcrn — Agent Skill

Name: Swiss Phone Directory
Rating: 4.2 (5 reviews)
Author: dvcrn

Swiss Phone Directory

Swiss phone directory lookup via search.ch API. Search for businesses, people, or reverse-lookup phone numbers. Use when: (1) finding contact details for Swiss companies or people, (2) looking up addresses by name or phone number, (3) reverse phone number lookup, (4) finding business categories. Requires SEARCHCH_API_KEY.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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 - 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)

Request a key: https://search.ch/tel/api/getkey.en.html
Fill out the form (name, email, use case)
Approval: ~10-15 minutes, key arrives via email

Set the Environment Variable

export SEARCHCH_API_KEY="your-api-key-here"

For permanent setup, see 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

---name: swiss-phone-directorydescription: Swiss phone directory lookup via search.ch API. Search for businesses, people, or reverse-lookup phone numbers. Use when: (1) finding contact details for Swiss companies or people, (2) looking up addresses by name or phone number, (3) reverse phone number lookup, (4) finding business categories. Requires SEARCHCH_API_KEY.---# Swiss Phone Directory SkillSearch the Swiss phone directory (search.ch) for businesses, people, and phone numbers.## Quick Start```bash# Search for a businesspython3 scripts/searchch.py search "Migros" --location "Zürich"# Search for a personpython3 scripts/searchch.py search "Müller Hans" --type person# Reverse phone number lookuppython3 scripts/searchch.py search "+41442345678"# Business-only searchpython3 scripts/searchch.py search "Restaurant" --location "Bern" --type business --limit 5```## Commands### searchSearch for businesses, people, or phone numbers.```bashpython3 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 Rapperswilpython3 scripts/searchch.py search "Restaurant" -l "Rupperswil" -t business -n 5# Find a person by namepython3 scripts/searchch.py search "Meier Peter" -l "Zürich" -t person# Reverse lookup a phone numberpython3 scripts/searchch.py search "044 123 45 67"# Search with canton abbreviationpython3 scripts/searchch.py search "Bäckerei" -l "SG"```## Output FormatResults 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.html2. Fill out the form (name, email, use case)3. **Approval:** ~10-15 minutes, key arrives via email### Set the Environment Variable```bashexport 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

Frequently asked questions