Swiss Phone Directory

核心功能

Swiss Phone Directory 是一个基于 search.ch API 的瑞士电话簿查询工具，专为需要获取瑞士境内企业和个人联系信息的场景设计。核心能力包括：

1. 企业搜索 - 按名称、类别、地点查找瑞士公司，支持按城市、邮编、街道或州缩写（如 ZH、SG）精确定位
2. 个人查询 - 通过姓名和地点组合查找个人联系方式
3. 反向号码查询 - 输入电话号码即可查询归属主体（企业或个人）
4. 智能格式化输出 - 自动生成可点击的电话链接（tel: 协议），支持移动端一键拨号

显著优点

• 数据来源权威：直接对接瑞士最大电话簿平台 search.ch，覆盖瑞士全境商业和个人名录
• 多语言支持：输出可选德语、法语、意大利语、英语，适应瑞士多语言环境
• 灵活的地理过滤：支持城市名、邮编、街道、州缩写等多种定位方式
• 开发者友好：纯命令行工具，易于脚本集成和自动化工作流

潜在局限

• 地域限制：仅限瑞士境内数据，无法查询其他国家/地区
• API 依赖：需申请并维护 API key，免费 tier 可能有速率限制
• 隐私边界：个人数据受瑞士隐私法规约束，部分信息可能受限
• 无实时验证：无法保证号码当前是否有效或业务是否存续

适合人群

• 在瑞士开展业务需要本地客户/供应商联系方式的销售和商务人员
• 需要验证瑞士企业或个人的研究人员、记者、调查员
• 处理瑞士客户支持的客服团队
• 开发瑞士本地服务集成者的技术团队

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 数据准确性 | 名录数据可能存在滞后或错误 | 重要联系前二次确认 |

| 隐私合规 | 个人数据查询需符合 GDPR/瑞士隐私法 | 仅限合法用途，避免批量爬取 |

| API 可用性 | 第三方服务可能变更或中断 | 实现错误处理和降级策略 |

| 费用控制 | 超出免费 tier 可能产生费用 | 监控用量，了解计费规则 |

核心用法

Swiss Phone Directory 是一款面向瑞士地区的电话目录查询 Skill，通过 search.ch 官方 API 实现企业、个人及反向号码检索功能。用户可通过自然语言或结构化命令发起查询：搜索企业时指定名称与城市（如 "Migros Zürich"）；查找个人需标注 --type person 并配合地理位置过滤；反向号码查询直接输入电话号码即可获取归属信息。输出结果包含名称、地址、电话（支持 Markdown tel: 一键拨号）、传真、邮箱及企业分类等完整字段，默认德语输出并支持法/意/英多语言切换。

显著优点

该 Skill 的最大优势在于零依赖架构——完全基于 Python 3 标准库（urllib、xml.etree、argparse）实现，彻底规避供应链攻击风险。代码结构清晰、输入验证完善，通过 HTTPS/TLS 1.2+ 加密传输保障通信安全。功能层面覆盖瑞士全境商业实体与个人联系方式，反向号码查询能力可有效识别陌生来电。输出格式高度实用，电话号码自动转换为移动端可点击的 tel: 协议链接，支持 Telegram、Signal、WhatsApp 等应用一键拨号。API Key 申请流程简便（10-15 分钟邮件审批），免费 tier 即可满足日常查询需求。

潜在缺点与局限性

地理覆盖存在明显边界：仅限瑞士联邦境内，对德国、奥地利等周边德语区国家无支持。数据实时性依赖 search.ch 官方更新，部分小微企业或近期变更的号码可能存在滞后。API Key 通过 URL 参数传递虽经 HTTPS 加密，但仍存在服务端日志、浏览器历史等意外记录风险——此为 search.ch API 设计局限，非 Skill 本身缺陷。输出语言虽支持四种官方语言，但中文查询需自行翻译为德/法/英。此外，未声明开源许可证导致使用权限不明，建议用户联系作者确认。

适合的目标群体

• 在瑞华人/留学生：快速查找本地企业客服、餐馆预约、维修服务等联系方式
• 跨境商务人士：核实瑞士合作企业公开信息、验证商业实体真实性
• 客服/销售团队：批量查询潜在客户或供应商的官方联系电话
• 研究人员：获取瑞士中小企业的基础公开商业数据进行合规分析

使用风险与注意事项

常规风险集中于API 调用配额与速率限制：免费 API Key 存在调用频率上限，高频查询可能触发限流。建议实现本地缓存机制减少重复请求。网络层面已配置 15 秒超时，但弱网环境下仍需考虑超时与重试逻辑。隐私合规方面 Skill 本身符合 GDPR 最小数据原则，不存储用户查询内容，但用户需自行保管 API Key，避免硬编码在共享脚本中。性能方面因零第三方依赖，启动与执行速度优异，适合集成至自动化工作流。