Swiss Phone Directory

核心用法

Swiss Phone Directory 是基于 search.ch 官方 API 的瑞士电话簿查询工具，主要提供三类搜索能力：企业搜索（按名称、类别、地区）、个人搜索（按姓名及地理位置）、以及反向电话号码查询（识别号码归属）。用户可通过命令行指定位置（城市、邮编、街道或州缩写）、结果类型（business/person/all）和返回数量，支持德语、法语、意大利语、英语四种输出语言。

显著优点

1. 数据源权威：直接对接瑞士电信官方 search.ch 数据库，覆盖瑞士全境的企业和个人登记信息，准确率高
2. 功能完整：不仅支持正向搜索，还提供反向号码查询，可识别陌生来电归属
3. 灵活筛选：支持按州（如 ZH、SG）、城市、街道等多级地理位置过滤
4. 多语言支持：输出可切换四种官方语言，适应瑞士多语言环境

潜在缺点与局限性

• 地域严格受限：仅覆盖瑞士（Swiss），无法查询其他国家/地区号码
• 需要 API Key：必须申请 SEARCHCH_API_KEY 才能使用，存在使用门槛
• 隐私合规边界：个人数据查询受瑞士数据保护法规约束，商业用途需额外注意合规性
• 无实时验证：电话号码状态（是否仍有效）无法实时确认

适合人群

• 在瑞士开展业务的企业销售人员（B2B 客户开发）
• 需要验证瑞士本地联系方式的跨境商务人士
• 处理瑞士客户线索的 CRM 数据清洗场景
• 需要识别瑞士来电号码的个人用户

常规风险

| 风险类型 | 说明 |

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

| 隐私合规 | 个人数据查询需遵守瑞士 FADP 数据保护法，避免批量爬取 |

| API 限流 | 不同 API Key  tier 有调用频率限制，高频场景需申请商业授权 |

| 数据时效 | 电话簿更新存在延迟，关键商务决策建议二次验证 |

| 误匹配风险 | 常见姓氏（如 Müller、Meier）可能返回大量结果，需结合地址精确筛选 |

核心用法

Swiss Phone Directory Skill 是一款专注于瑞士本地电话目录查询的实用工具，通过调用 search.ch 官方 API 实现企业、个人及反向号码查询三大核心功能。用户可通过命令行或 Agent 集成方式，输入名称、地址片段或电话号码，快速获取包含完整联系方式的结构化数据。

主要功能场景：

• 企业搜索：按行业类别（如餐厅、面包店）+ 地理位置筛选目标商家
• 个人查找：通过姓名组合（支持德语区常见姓名格式）定位个人联系方式
• 反向查询：输入电话号码直接反查归属主体（企业或个人）
• 多语言支持：结果可输出德语、法语、意大利语或英语

使用方式简洁直观，仅需配置 SEARCHCH_API_KEY 环境变量即可调用，支持通过 --location 指定城市/ZIP/街道/州缩写，--type 限定返回类型，--limit 控制结果数量。

显著优点

1. 零依赖架构：纯 Python 标准库实现，293 行代码分布于 4 个文件，无第三方包引入，极大降低供应链攻击面和维护成本
2. 官方可信数据源：直接对接 Swisscom Directories AG 运营的 search.ch 平台，瑞士市场占有率最高的电话目录服务，数据权威性有保障
3. 安全防护完善：无危险函数（eval/exec/system）、无硬编码密钥、HTTPS 加密传输、15 秒超时机制、完整错误处理，静态与动态分析均获高分
4. 输出结构化：返回包含姓名、类型、完整地址、电话/传真/邮箱/网址、业务分类的标准化字段，便于下游自动化处理
5. 隐私合规：遵循 GDPR 数据最小化原则，仅传输必要查询参数，不采集或留存用户敏感信息

潜在缺点与局限性

1. 地理覆盖受限：数据源仅限瑞士境内（含列支敦士登部分地区），对国际号码或非瑞士实体无覆盖能力
2. API 密钥门槛：需用户自行申请 search.ch API 密钥并配置环境变量，对非技术用户存在使用门槛
3. 速率限制未内建：当前实现未内置请求节流或缓存机制，高频调用可能触发服务商限流
4. 输入验证待增强：缺少对查询参数长度的硬性限制，极端长输入可能导致 URL 构造异常或资源消耗
5. 错误提示可优化：API 密钥无效时仅返回 HTTP 403 原生错误，建议增加密钥格式预校验与友好提示

适合的目标群体

• 在瑞企业/机构：需要验证合作伙伴联系方式、拓展本地供应商网络的商务团队
• 跨境服务从业者：律师、会计师、房产中介等需频繁核实瑞士客户/标的物联系信息的职业群体
• 数据清洗工程师：构建瑞士企业主数据（MDM）系统、进行地址标准化与去重的技术人员
• 学术研究用户：社会学、商业地理学研究中需批量获取瑞士商业网点分布的研究者
• 瑞士本地居民：反向查证陌生来电、寻找特定服务商户的日常查询需求

使用风险

| 风险类别 | 等级 | 说明 |

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

| 依赖项安全 | 极低 | 零第三方依赖，无供应链风险 |

| 代码执行安全 | 极低 | 无动态代码执行，无反序列化风险 |

| 数据外泄 | 低 | 查询内容发送至 search.ch 服务器，已通过 TLS 加密；用户应知晓搜索词被传输至第三方 |

| 凭证泄露 | 低 | API 密钥由用户自行管理，需避免在版本控制或共享环境中暴露 |

| 服务可用性 | 中 | 依赖 search.ch 在线服务，网络波动或 API 变更可能影响功能；建议实施重试机制 |

| 结果准确性 | 中 | 数据源更新存在延迟，部分企业或个人信息可能未及时同步，关键业务建议二次核实 |

总体评估：该 Skill 在安全性与代码质量方面表现优异，适合生产环境使用，但建议采纳认证报告中的增强建议（重试机制、输入长度限制、结构化日志）以进一步提升健壮性。