名称： swiss-phone-directory
描述： "通过 search.ch API 查询瑞士电话簿。可搜索企业、个人或进行电话号码反查。适用场景：(1) 查找瑞士公司或个人的联系方式，(2) 通过姓名或电话号码查询地址，(3) 电话号码反查，(4) 查找企业类别。需要配置 SEARCHCH_API_KEY。"
元数据：
openclaw:
requires:
env:
- SEARCHCH_API_KEY

瑞士电话簿查询技能

通过 search.ch API 查询瑞士电话簿，支持搜索企业、个人及电话号码。

快速开始

# 搜索企业
python3 scripts/searchch.py search "Migros" --location "Zürich"

# 搜索个人
python3 scripts/searchch.py search "Müller Hans" --type person

# 电话号码反查
python3 scripts/searchch.py search "+41442345678"

# 仅搜索企业
python3 scripts/searchch.py search "Restaurant" --location "Bern" --type business --limit 5

命令说明

search

搜索企业、个人或电话号码。

python3 scripts/searchch.py search <查询内容> [选项]

选项：
  --location, -l    城市、邮编、街道或州（例如："Zürich"、"8000"、"ZH"）
  --type, -t        筛选类型："business"（企业）、"person"（个人）或 "all"（全部，默认）
  --limit, -n       最大结果数（默认：10，最大：200）
  --lang            输出语言：de, fr, it, en（默认：de）

使用示例

# 查找 Rapperswil 的餐厅
python3 scripts/searchch.py search "Restaurant" -l "Rupperswil" -t business -n 5

# 按姓名查找个人
python3 scripts/searchch.py search "Meier Peter" -l "Zürich" -t person

# 反查电话号码
python3 scripts/searchch.py search "044 123 45 67"

# 使用州缩写搜索
python3 scripts/searchch.py search "Bäckerei" -l "SG"

输出格式

返回结果包含以下字段（若存在）：
- 名称 - 企业或个人名称
- 类型 - 机构或个人
- 地址 - 街道、邮编、城市、州
- 电话 - 可点击的 tel: 链接（例如：[044 123 45 67](tel:+41441234567)）
- 传真 - 可点击的 tel: 链接
- 邮箱 - 电子邮件地址
- 网站 - 网站 URL
- 类别 - 企业类别

可点击的电话号码 📞

电话号码会自动格式化为带 tel: 协议的 Markdown 链接：

📞 [044 123 45 67](tel:+41441234567)

这使移动设备（Telegram、Signal、WhatsApp 等）支持一键拨打。

如需禁用可点击链接，请使用 --no-clickable 选项。

配置说明

获取 API 密钥（免费）

1. 申请密钥： https://search.ch/tel/api/getkey.en.html
2. 填写表单（姓名、邮箱、用途说明）
3. 审批流程： 约 10-15 分钟，密钥将通过邮件发送

设置环境变量

export SEARCHCH_API_KEY="您的 API 密钥"

如需永久配置，请参阅 references/configuration.md。

API 参考

• 基础 URL：https://search.ch/tel/api/
• 速率限制：取决于 API 密钥等级
• 完整文档：https://search.ch/tel/api/help.en.html