swiss-phone-directory

Swiss Phone Directory 是一款专注于瑞士地区电话信息查询的实用工具，通过集成瑞士本土权威的 search.ch 电话簿 API，为用户提供企业、个人及反向电话号码查询服务。该技能采用纯 Python 标准库开发，无需任何第三方依赖，在保证功能完整性的同时最大程度降低了安全风险。

核心用法方面，用户可通过命令行接口执行多种查询场景：按名称搜索瑞士企业或个人、基于地理位置筛选商家、以及通过电话号码反向查找归属信息。查询结果自动格式化为 Markdown 格式，其中电话号码生成可点击的 tel: 协议链接，支持在移动端一键拨号，极大提升了商务场景的联络效率。所有查询均通过官方 API 实时获取，确保数据的时效性和准确性。

该技能的显著优点体现在多个维度。首先，代码层面仅依赖 Python 内置库（urllib、xml.etree.ElementTree 等），彻底杜绝了第三方依赖包带来的供应链攻击风险。其次，安全设计严谨，完全摒弃了 eval、exec、subprocess 等危险函数，输入参数经过严格验证（如限制返回数量不超过 200 条），错误处理机制完善且不会泄露敏感配置信息。此外，功能描述透明，权限申请与用途完全匹配，无静默数据收集行为，用户完全掌控 API 密钥的配置权。

然而，该技能也存在一定局限性。地域上仅限瑞士地区查询，无法覆盖其他国家；使用门槛上需要用户自行前往 search.ch 申请免费 API 密钥，审批流程约需 10-15 分钟；网络层面完全依赖 search.ch 服务的可用性，且查询关键词需发送至第三方服务器，虽为公开数据但仍有隐私考量。作为 T3 级社区来源项目，长期维护稳定性也略逊于商业软件。

目标用户群体主要包括：在瑞士开展业务的商务人士（查找企业联系信息）、在瑞士居住生活的个人用户（查找本地服务）、以及需要验证电话号码归属的客服或销售人员。对于需要频繁联系瑞士本地商家、餐厅、医疗机构的用户尤为实用。

使用风险方面，除常规的 API 服务可用性风险外，用户需注意妥善保管 SEARCHCH_API_KEY 环境变量，避免在公共代码仓库中硬编码敏感凭证。同时应遵守 search.ch API 的使用条款和速率限制，避免高频调用导致账户受限。由于查询内容会明文传输至 search.ch 服务器，不建议在查询中输入高度敏感的个人隐私信息。