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.

Security Scan

The skill is an internally consistent wrapper for the search.ch phone-directory API and only requests the expected SEARCHCH_API_KEY credential; nothing in the code or instructions appears to try to access unrelated data or external endpoints.

Purpose & Capability

The name/description match the behavior: the code queries search.ch and parses results. The only required environment variable (SEARCHCH_API_KEY) is appropriate for this purpose.

Instruction Scope

Runtime instructions and examples are focused on calling the search.ch API and setting SEARCHCH_API_KEY. They format results as Markdown/tel: links (one-tap calling). Minor documentation mismatches exist: SKILL.md examples reference scripts/searchch.py and references/configuration.md whereas the repository contains searchch.py and configuration.md at the top level. This is a usability/documentation issue, not a security inconsistency.

Install Mechanism

No install spec is provided (instruction-only). A single Python script is included; there are no downloads, package installs, or extract steps, so nothing is written to disk by an installer beyond the included file.

Credentials

Only SEARCHCH_API_KEY is requested. No unrelated secrets, system paths, or other credentials are required or referenced in the code or documentation.

Persistence & Privilege

The skill is not marked always:true and does not request elevated or persistent system-wide privileges. Autonomous invocation is allowed by default (platform normal) but the skill's scope remains limited to API queries.

Assessment

This skill appears to do what it says: call search.ch using your SEARCHCH_API_KEY and format results. Before installing: (1) confirm you obtained your API key from https://search.ch/tel/api/getkey.en.html and understand the API terms (attribution/rate limits), (2) be careful not to expose the SEARCHCH_API_KEY in public logs or chat messages, (3) note and correct minor documentation path mismatches (SKILL.md references scripts/searchch.py and references/configuration.md while the files are at the repo root) to ensure the examples run as shown, and (4) if you will allow autonomous agent invocation, consider limiting the agent's permission to use this skill or monitoring its queries to avoid unwanted lookups. If you want higher assurance, run the included searchch.py in a sandboxed environment and inspect network traffic to verify calls go only to search.ch.

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 "[phone]"

# 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:[phone]))
• 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:[phone])

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

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