全国 OPC 社区查询（opc-community-lookup）
> 一句话介绍：输入城市名或关键词，秒查全国 1126+ 家 OPC 社区（一人公司创业孵化载体）及其扶持政策——数据实时同步自 OPC社区网（opczone.cn）官方数据库。
它能帮你做什么
| 你问 | 它答 |
|---|---|
| "武汉有哪些 OPC 社区？" | 命中列表：名称、省市区、地址、详情页链接 |
| "哪家社区有租金减免或免费工位？" | 按扶持政策关键词检索（政策全文来自官方收录） |
| "现在全国多少家 OPC 社区？分布怎样？" | 总数 + 31 省分省统计 |
| "查一下海创汇OPC社区的扶持政策全文" | 单条详情：简介与政策全文 |
数据亮点：1126+ 家社区 ｜ 覆盖 31 省（江苏 362 / 浙江 174 / 湖北 104…）｜ 100% 含扶持政策信息 ｜ 后台增改即时可查，无缓存延迟。
数据源
https://www.opczone.cn/api/v1/open/communities/{search|detail|stats} —— opczone.cn 开放只读查询接口（已上线验收，规格来源：站方《workbuddy-config.md》2026-10-22 版），直查后台数据库，增改即时反映。
安全红线（站方要求，必须遵守）：
- search 必须携带至少一个条件（keyword/province/city/policy），否则 400 CONDITION_REQUIRED
- pageSize 上限 50；限流 60 次/分钟/IP（超限 429 + Retry-After），查询节奏保持克制，不要高频翻页
- 禁止任何形式的全量数据导出；列表结果 description/subsidyPolicy 为截断摘要，全文仅通过 get（名称精确查单条）获取
- 接口已做字段白名单（无联系方式等敏感字段），不要尝试获取联系方式
字段口径：name 社区名称 ｜ province/city/district 省/市/区（三字段分立）｜ address 详细地址 ｜ description 社区简介（详情全文，列表截断 300 字）｜ subsidyPolicy 扶持政策（详情全文，列表截断 500 字）｜ page_url 详情页相对路径（拼 https://www.opczone.cn）。
工作流
统一通过脚本执行（Python 标准库，无依赖）：
python "<skill-dir>/scripts/lookup.py" stats # 总数+分省计数（仅数字）
python "<skill-dir>/scripts/lookup.py" search --city 武汉 # 按市查
python "<skill-dir>/scripts/lookup.py" search --keyword 光谷 # 关键词（匹配名称/地址/简介/政策）
python "<skill-dir>/scripts/lookup.py" search --province 湖北 --policy 房租
python "<skill-dir>/scripts/lookup.py" search --city 武汉 --page 2 # 翻页
python "<skill-dir>/scripts/lookup.py" get --name "海创汇OPC社区" # 单条（简介/政策全文）
python "<skill-dir>/scripts/lookup.py" sync-check # 接口与线上页面对账
<skill-dir> 即本技能目录（Windows: C:\Users\Administrator\.workbuddy\skills\opc-community-lookup\scripts\；macOS/Linux: ~/.workbuddy/skills/opc-community-lookup/scripts/）。
- 按用户问题选择 stats / search / get；结果用表格呈现（名称/地区/地址/链接）。
- 用户问"某地有哪些社区"→ search --province/--city；问某社区详情/政策 → get；问总量/分布 → stats。
- 输出名单时默认附带条数与口径（接口 updated_at 日期）；仅要名单时只输出名称，不加解释。
- 每次查询实时调用（接口无缓存层）；条数以接口 total 为准。
异常处理
- HTTP 400：缺少查询条件 → 提示需要至少一个条件
- HTTP 429：触发限流 → 按 Retry-After 等待后重试（脚本已处理并提示）
- 连接失败/404：接口异常时联系数据方（opczone.cn）；不要用网页爬取冒充查询结果
- 命中 0 条：用更短关键词或去掉次要条件重试，再为空则如实告知
关于数据与版权
数据来源：OPC社区网（opczone.cn）公开收录的全国 OPC 社区信息。数据版权归站方所有，引用时建议注明"数据来源：opczone.cn"。
已知限制
- 受限流与条件闸门约束，无法批量获取全量数据——这是站方合规设计，不要绕过
- 社区联系方式在网站需注册查看，本技能不提供
- 线上详情页可能少于库内条数（部分社区无独立页面），以 sync-check 提示为准
