乡镇银行网点核心客群清单 Skill
定位
本 Skill 帮助用户获取指定乡镇的三类核心客群清单(小微企业 / 商户 / 农户),供银行网点外拓营销使用。全部数据必须来自真实可溯源来源(工商注册信息、地图 POI、官方名单),禁止虚构。
典型场景:乡镇网点客户开发规划、外拓营销名单准备、普惠金融/乡村振兴信贷目标筛选、涉农主体建档。
输入参数
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| 目标乡镇 | ✅ | 精确到乡镇(含上级省/市/县区,避免同名歧义) | 河北省石家庄市晋州市东卓宿镇 |
| 客群范围 | ❌ | 小微企业 / 商户 / 农户 三类可指定 | 默认三类全取 |
| 匹配联系方式 | ❌ | 是否通过工商API补联系方式 | 默认"是"(普通乡镇充分取数;经济强镇/市区街道先评估再定) |
| 输出格式 | ❌ | Markdown / Excel | 默认 Markdown+Excel |
⛔ 铁律:禁止虚拟数据 & 禁止幻觉
- ❌ 禁止捏造企业、商户、农户名称与数量
- ❌ 禁止编造注册信息、联系方式、地址
- ❌ 禁止将其他乡镇/区域的数据套用到目标乡镇
- ❌ 禁止使用示例数据、估算值替代真实来源
- ❌ 禁止 API 失败后继续制表或自行补写
唯一合法来源:
- 天眼查/企查查/质数幻方等工商数据平台返回的真实注册信息(农民专业合作社、家庭农场、农业企业、工商企业)
- 高德/腾讯/百度地图 POI API 返回的真实商户点位
- 农业农村部门官方名录(示范社/示范家庭农场)、政府文件、官媒报道
数据标注:✅多源印证/官方 / ⚠️单一来源 / ❌未获取。信息不完整时如实告知,绝不填充。
第零步:本地资源普查与清单记录(强制)
> 设计原则:不同智能体/环境下,同类资源(地图、工商)的接入方式可能完全不同(环境变量 Key、MCP 连接器、CLI 脚本、第三方工具……)。因此不做"固定检测某几个源",而是全面普查当前环境所有可用资源,再决定"够不够用、怎么用、记录什么"。
Step 0.1 全面普查(探测所有可能的接入方式,不预设清单):
| 资源类别 | 探测范围(不限于此,实际环境可能更多) | 探测方法 |
|---|---|---|
| 网络搜索 | 内置 WebSearch | 必有 |
| 地图 POI | ① 环境变量:AMAP_KEY/TENCENT_KEY/TENCENT_MAP_KEY/BAIDU_AK;② MCP 连接器:amap-maps/tencent-map/baidu-maps(用 ToolSearch 探测工具名);③ 第三方脚本:street-merchant-list 的 api_clients/*.py、city-merchant-heatmap 的 fetch_poi.py/multi_poi.py |
逐个探测,每个源试搜一次验证真实可用(如高德 text_search、腾讯 placeSuggestion、百度 search_places) |
| 工商数据 | ① 天眼查 CLI(~/.tyc/config.json + tyc_tools.py);② MCP 连接器:qcc-company(企查查)、tyc-mcp(天眼查);③ 自定义 MCP:yjidian-company 等(质数幻方);④ 其他工商平台(企查查/启信宝/同花顺快查等,视环境而定) |
ToolSearch 探测工具名;实测调用一次(如 search_companies / get_company_by_query / get_registration_info)确认可用与配额 |
| openpyxl | import openpyxl |
缺失则 Excel 交付降级为 Markdown |
Step 0.2 资源充足性评估(决定"直接做"还是"先补资源"):
- 判定标准:至少 1 个可用地图源 + 1 个可用工商源 且网络搜索正常 → 资源足够,正常执行
- 资源太少(≤1 类核心资源缺失) → 暂停,向用户展示"当前可用资源清单 + 缺失项 + 配置指引(见 references/data-guide.md)",请用户补齐资源后再使用;用户明确授权降级时(如仅做官方名单+POI),按授权执行并在报告中注明
Step 0.3 资源清单记录(资源够用时,强制):
- 把本次普查到的可用资源清单与调用方式写入本 SKILL 的
references/local-resources.md(若已存在则更新覆盖): - 可用地图源:名称 / 接入方式(MCP 工具名或环境变量)/ 实测状态(✅可用/⚠️有限)
- 可用工商源:名称 / 接入方式 / 批量能力(有/无)/ 配额状态(如"天眼查当日配额耗尽")
- 注意事项:踩坑记录(如"腾讯地图需清空 IP 白名单""质数幻方域名 mcp.yidian.cn")
- 价值:同一环境下次使用时,先读
local-resources.md即可快速定位可用资源,无需重复全面探测;环境变化(新配 Key、配额恢复)时更新该文件 - 同时将关键资源状态追加到工作区记忆(
.workbuddy/memory/YYYY-MM-DD.md),供跨会话参考
工作流程总览
第零步:本地资源普查(探测所有地图/工商接入方式)→ 资源不足则提示补配置 → 资源够用则记录资源清单到 local-resources.md
↓
Step 1:参数解析 + 区域识别(乡镇→上级行政区→类型判断)
↓
Step 2:范围评估与资源提醒(普通乡镇→充分取数;地市直属/经济强县/市区街道→醒目提醒主体过多)
↓
Step 3:官方"白名单"预检索(示范园/龙头企业/项目名单/政府报告 → 提取主体名;仅补充+覆盖率评估,非主渠道)
↓
Step 4:三类客群穷举采集(★核心:当前环境所有可用资源的一切功能并行取数——天眼查翻页/企查查穷举/质数幻方核验/POI三源/网络搜索,各按其能力分工,联系方式随清单同取)
↓
Step 5:集聚分析(企业/商户/农业主体集中的街区、村社识别 → 营销方向)
↓
Step 6:行业协会/商会/专业市场检索
↓
Step 7:展示数据概况 + 分析结论 → 用户确认
↓
Step 8:输出清单 + 营销指引报告(Markdown + Excel 分Sheet)
↓
Step 9:联系方式补漏(采集期已同步获取,仅补剩余缺口)
Step 1:参数解析 + 区域识别
解析目标乡镇,明确:
- 乡镇名称 + 上级行政区(省/市/县区)——乡镇名常有重复(如"城关镇"全国数百个),必须带上级行政区定位
- 乡镇类型判断(用于 Step 2 资源提醒):
- 普通乡镇(县域下属乡镇)
- 地市直属/市直管乡镇(如直辖县、县级市城区所在镇)
- 经济强县下属乡镇(百强县/GDP强县)
- 市区街道(地级市市辖区下辖街道/镇)
> 若上级行政区不明,先向用户确认"该乡镇属于哪个县区/市辖区"。
Step 2:范围评估与资源提醒(强制)
在开始采集前,先向用户说明资源消耗预估:
📊 查询范围评估
- 目标乡镇:<XX省XX市XX县区 XX镇>
- 乡镇类型:普通乡镇 / 地市直属 / 经济强县下属 / 市区街道
- 预计主体规模:
- 小微企业:约 XX 家(工商口径)
- 商户:约 XX 家(POI口径,视乡镇发达程度)
- 农户(新型农业主体):约 XX 家
- 资源消耗:工商API约 X 次调用 / 地图POI约 X 次(免费)
资源提醒规则(必须执行):
- 目标为普通乡镇(县域下属乡镇,绝大多数情况)→ 默认充分取数:所有可用资源全量并行采集、企业清单尽量全量、联系方式默认全量匹配,不主动限制范围。仅简要说明预计规模即可开始。
- 目标为地市直属乡镇、经济强县下属乡镇、市区街道 → 醒目提醒:"该区域市场主体密集,全量查询可能消耗较多资源(工商API配额有限),建议:① 聚焦单一客群类别;② 指定重点产业/区域缩小范围;③ 或先取部分样例评估规模"——此时再与用户确认取数范围与联系方式匹配范围,按确认执行
- 无论何种类型,地图 POI 均全额采集(免费额度充足,不受限制)
Step 3:官方"白名单"预检索(补充 + 取数结果评估,非主渠道)
> 定位(v2.0 延续):官方名单/政府报告整理出的主体仅作补充和取数结果评估——① 补充穷举式采集遗漏的高价值主体(如国家级/省级示范社、规上企业);② 对照评估穷举结果的覆盖率(如"官方称合作社189家,穷举覆盖19家=10%")。不能以官方名单代替工商穷举采集,更不能只核验官方名单就交付。主渠道仍是 Step 4 的全资源并行穷举。
> 实测教训(多宝镇案例):仅靠"乡镇名+关键词"工商检索,会漏掉名称不带乡镇名的高价值主体(如注册名只带"天门市"前缀的国家级示范社、市级示范主体),且工业企业/电商企业因关键词偏农业而 0% 覆盖。官方公开名单是最权威、免费、可全量的主体目录,必须先检索。
检索目标(县区级主管部门官网,通常带"乡镇"字段可直接过滤目标乡镇):
1. 农业农村局:<县区> 精品示范园 主体名单、<县区> 示范合作社/示范家庭农场 名单、<县区> 新型农业经营主体 名单、<县区> 农业产业化 龙头企业 名单
2. 乡村振兴/扶贫部门:<县区> 产业奖补 新型农业经营主体、<县区> 乡村产业致富带头人
3. 农业农村局项目名单:<县区> 部级/省级 项目 实施主体名单(如绿色高产高效项目、高标准农田项目)
4. 镇政府文件:<乡镇> 政府工作报告、<乡镇> 镇情简介、<乡镇> 在线访谈、<乡镇> 企业家座谈会——直接点名规上企业、限上企业、重点合作社
要点:
- 从名单中提取主体名 → 反向用工商 API 核验详情(比正向盲搜覆盖率高得多)
- 政府报告/镇情中"规上X家、限上X家、龙头企业X家(省级X市级X)、新型主体X家(国家级X/省级X/市级X)"等统计,直接给出核验优先级依据——优先核验国家级/省级/规上主体
- 此项仅消耗网络搜索,不消耗工商配额
官方名单主体核验(实测高效流程,首选质数幻方):
- 首选质数幻方 mcp__yjidian-company__get_registration_info:一次调用即返回完整工商照面+联系方式(法人/注册资本/成立日期/地址/电话/邮箱/信用代码),无每日配额限制(多宝镇实测连查 17 家无限流),是官方名单主体核验最高效工具
- 名称匹配技巧:① 官方报道简称(如"冠华科技")≠ 工商全称("湖北省天门市冠华科技有限公司")——先 get_company_precise_name 模糊搜索锁定,再取登记信息;② 家庭农场常注册为"个体工商户"且名称带"乡镇名"前缀,直接 get_registration_info("<县区><乡镇>XX家庭农场") 命中率更高;③ 模糊搜索多候选时必须核对注册地址在目标乡镇,防同名干扰
- 简称核验限制:官方报道中的企业简称(如"海润电子""杰鑫农业")若模糊搜索无乡镇内命中,标注"待确认",不得臆断匹配外地同名企业
- 互补:质数幻方核验工商照面;企查查 get_contact_info 补联系方式(质数幻方登记信息已含电话/邮箱,通常无需重复调用)
Step 4:三类客群穷举采集(★核心)
> ⭐ 核心原则(v2.0,强制):
> 1. 充分使用当前环境已有资源的一切功能并行取数,不设主次——天眼查翻页、企查查穷举轮询、质数幻方详情核验、地图 POI 三源、网络搜索、官方名单,凡第零步普查确认可用的资源全部调用,各按其能力分工(批量列表/模糊搜索/详情+联系方式/点位/名录),任何可用源不得因"已有别的源"而跳过。
> 2. 全量补采不降级——某源配额耗尽/不可用时,其余源必须继续尽力补足(天眼查 402 → 企查查穷举 + 质数幻方核验照常执行),不得因此降低清单覆盖率;全部资源都尽力后仍不足才如实说明覆盖率。
> 3. 联系方式能同时取就一次取,不分成两次——接口能顺带返回电话/邮箱的(质数幻方 get_registration_info、百度 POI 带电话、企查查部分返回),在采集清单的同时直接落库;不要"先出清单、后补联系方式"分成两轮。只有接口确实不返回时,才用专门工具补。
> 4. 官方名单仅作补充和取数结果评估——官方名单/政府报告整理出的主体只用于:① 补充穷举遗漏的高价值主体;② 对照评估穷举结果的覆盖率。不能以官方名单代替穷举式采集,更不能只核验官方名单就交付。
4a. 小微企业(工商全量查询 + 大中型标注)
逻辑:乡镇通常企业数量不多(几十至几百家),可全量查询。注册登记主体类型包括:有限责任公司、股份有限公司、个人独资企业、合伙企业、集体所有制企业等。
采集方式(各资源能力分工,全部调用,去重合并):
- 天眼查(翻页批量列表):
search_companies("<乡镇名>")或 tyc-clicompany companies "<乡镇名>" --pageSize 20 --pageNum N(⚠️ 实测(2026-08-09):每页实际返回上限 20 条(非100),但--pageNum翻页有效且可连续拉取——"乡镇名+关键词 + 逐页翻页"即可获得该关键词全量清单。实测效果:嘉鱼县潘家湾镇翻页 10 页 = 200 家主体(名称含镇名 34 家 + 模糊匹配 166 家);嘉鱼县合作社翻页 5 页 = 98 家县区级合作社。复用 new-enterprise-query 的tyc_tools.py。⚠️ 翻页注意:① 每页固定 20 条,翻到不足 20 条即到底;② 搜索结果含"名称含乡镇名"(直接归属)与"模糊匹配"(名称不含乡镇名,多为注册地在园区/新城的主体,需核验注册地);③ 县区级关键词(如"嘉鱼县合作社")命中全县候选,需用get_registration_info逐一核验注册地址筛选本镇主体 - 企查查(穷举式轮询):
mcp__qcc-company__get_company_by_query("<县区名>+<乡镇名>+<产业关键词>")——每次最多5个候选,必须用大量差异化关键词穷举轮询。关键词库(实测有效):乡镇名+[合作社/种植/蔬菜/蔬菜种植/养殖/水产/水产养殖/渔业/莲藕/虾/水稻/粮食/农机/农资/农业/家庭农场/农副产品/农庄/农家乐/批发/商贸/超市/冷库/食品/餐饮/饭店/宾馆/旅社/酒店/服装/建材/五金/家电/摩托车/百货/副食/电商/快递/种子/肥料/渔需]等 30+ 组,每词 5 候选,去重合并——实测潘家湾镇 30+ 关键词轮询产出 120+ 家真实主体(合作社19/家庭农场7/各类经营部79+)。⚠️ 双层级关键词(重要,实测发现):仅搜"乡镇名+关键词"会漏掉名称不带乡镇名前缀的主体——大量合作社/家庭农场注册名只有"县区名+主体名"(如"嘉鱼县七彩果蔬专业合作社"注册地却在潘家湾镇),官方统计是按注册地址归属而非名称含乡镇名。必须补一轮"县区名+关键词"搜索(如"嘉鱼县合作社""嘉鱼县家庭农场"),命中候选再用get_registration_info核验注册地址/登记机关(登记机关为"XX市场监管所"=该镇主体),属本镇者纳入。必须过滤:① 外省同名乡镇干扰("潘家湾"有湖北/云南/陕西多处),按注册地址含目标县区过滤;② 县区级关键词命中后必须核验注册地(邻镇/县城主体剔除,如"嘉鱼县鸿庭农业"注册地在鱼岳镇);③ 注销/吊销主体标记后仍可保留(营销价值低但真实);④ 名称 100% 相同去重 - 质数幻方(详情 + 联系方式同取):
get_company_precise_name可按已知企业名/区域关键词返回候选(最多5个),get_registration_info一次返回完整工商照面+联系方式(含电话/邮箱),无每日配额限制——对穷举出的每个主体,直接用get_registration_info取完整信息(含联系方式),清单+联系方式一步到位,不分成两次。⚠️ 能力边界:precise_name按企业名匹配,直接搜"乡镇名+关键词"命中率低(实测"嘉鱼县潘家湾镇合作社"无结果),更适合已知主体精确核验。⚠️ 关键(实测踩坑):URL 路径参数是模块名(company 等,非 API Key 也非独立 serviceCode),API Key 仅用于 Bearer 头;域名是mcp.yidian.cn(不是 mcp.yjidian.cn)。配置自检:curl -H "Authorization: Bearer {API Key}" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -X POST -d '{"jsonrpc":"2.0","method":"initialize",...}' https://mcp.yidian.cn/mcp/company,返回event: message+serverInfo即正确;返回 404/401/HTML 即配置错误 - 地图 POI:
<乡镇> 公司/<乡镇> 企业搜索 + 各类业态关键词(补充地图上有标注但工商轮询未覆盖的商户点位;百度 POI 自带电话,一并落库)
> 工商源能力分工总览(实测确认,v2.0 更新):
> | 源 | 批量列表 | 穷举轮询 | 详情+联系方式 | 备注 |
> |------|:--:|:--:|:--:|------|
> | 天眼查 | ✅(翻页批量,每页20条连续翻页) | ✅ 按乡镇名/县区名翻页全量 | ✅ | 配额有限(每日约500次),恢复后优先;联系信息随清单一起取 |
> | 企查查 | ❌(无批量接口) | ✅ 30+关键词穷举 | ⚠️ 部分返回 | 大量主体发现靠它;联系方式靠质数幻方补 |
> | 质数幻方 | ❌(无批量接口) | ⚠️ 已知主体确认 | ✅ 一次返回完整照面+联系方式(无配额限制) | 清单+联系方式一步到位,穷举出的主体逐家用它补全 |
去重与标注:
- 名称100%相同合并、80-99%相似备注
- 大中型企业标注:注册资本 ≥ 1000万元 或 参保人数 ≥ 100 人 → 标注"大中型/规上候选"(作为重点客群);其余为小微企业(普惠金融目标)
输出字段:序号、企业名称、统一社会信用代码、法定代表人、注册资本、成立日期、经营状态、注册地址、经营范围、企业规模标注、数据来源
4b. 商户(参照 street-merchant-list 全镇采集)
逻辑:复用 street-merchant-list 的多源 POI 采集模式,获取全镇范围商户清单。
采集方式:
1. 地图 POI 三源采集(强制三源全部调用,不要只试一个源就降级):以乡镇政府/中心点为圆心,用周边搜索或关键词搜索采集全镇商户;高德(maps_text_search)、百度(map_search_places)、腾讯(placeSuggestion/placeSearchNearby)三源逐一调用、全部采集,三源去重合并(名称100%相同合并)。实测经验:百度 map_search_places 返回字段最丰富(含 town 乡镇字段、电话、品牌、营业时间),且常返回其他源没有的商户(如"鑫时代购物广场""亿联服饰购物广场"),town_code 可直接用于载体归类——三源必须逐一调用后再合并,不可只取一源
2. AI 网络搜索补充:乡镇商业街、集贸市场名单(标注来源,需可验证)
3. POI 类型过滤:保留购物/餐饮/住宿/生活服务等经营性业态;排除重复的地标/公交站等非商户 POI
数据处理(参照 street-merchant-list):门牌号提取、去重、按业态分类、按门牌号/位置排序。
输出字段:序号、商户名称、业态大类、业态细分、完整地址、门牌号、经度、纬度、数据来源
4c. 农户(新型农业主体,经工商注册信息获取)
⚠️ 重要:必须先向用户说明可获取范围——"新型农业经营主体"中,以下类型经市场监管部门登记注册、可通过工商数据获取:
| 主体类型 | 工商登记形式 | 获取方式 |
|---|---|---|
| 农民专业合作社(含联合社) | 企业类型"农民专业合作社",统一社会信用代码以 93 开头 | 天眼查/企查查按"<乡镇> 合作社"或类型筛选 |
| 家庭农场 | 登记为个体工商户或独资公司,名称含"家庭农场" | 按"<乡镇> 家庭农场"关键词搜索 |
| 农业企业(含农业产业化龙头企业) | 有限责任公司/股份公司,行业为农林牧渔 | 按"<乡镇> 农业"+"经营范围含种养殖/农产品"筛选 |
以下主体通常不注册、无法经工商获取(如实告知用户,标注❌):
- 专业大户(种养大户,未注册)
- 农业社会化服务组织(部分未注册)
- 一般小农户
采集方式:
1. 天眼查翻页 / 企查查关键词组合搜索:"<乡镇> 合作社"、"<乡镇> 家庭农场"、"<乡镇> 农业"、"<乡镇> 种植"、"<乡镇> 养殖"(天眼查 pageNum 翻页批量;企查查用"县区名+乡镇名+关键词"轮询,过滤同名干扰)
2. 按企业类型/名称/经营范围过滤出新型农业主体
3. 农业农村部门官方名录补充(示范社/示范家庭农场名单,若有)
4. 县区级关键词(如"<县区> 合作社")翻页/轮询,命中候选核验注册地归属(登记机关=XX市场监管所 即本镇主体)
> 同名乡镇防混淆:乡镇名在全国常重复(如"多宝镇"有湖北天门与黑龙江嫩江两处、"潘家湾镇"有湖北嘉鱼与云南/陕西多处),搜索必须以"县区名+乡镇名"为前缀,并逐条核对注册地。
输出字段:序号、主体名称、主体类型(农民专业合作社/家庭农场/农业企业)、法定代表人、成员出资总额/注册资本、成立日期、经营状态、注册地址、经营范围、数据来源
数据为空时
如实告知获取到 0 条,说明失败原因,停止该类别继续,询问调整后重试。
Step 5:集聚分析(营销方向指引)
基于 Step 4 采集结果,识别各类客群的空间集聚特征,为营销指明方向:
5.1 企业集聚识别:按注册地址/经营范围统计企业集中分布的街区、园区、村社(如"XX镇工业路一带集聚 N 家纺织企业")。
5.2 商户集聚识别:按 POI 点位密度识别商业集中街区(如"人民路—中山街商圈")、集贸市场周边、专业市场周边商户密集区。
5.3 农业主体集聚识别:按注册地址统计新型农业主体集中的村(如"XX村为合作社/家庭农场集中村"),识别特色种养带(如"XX河沿岸蔬菜种植带")。
5.4 输出集聚分析表(Markdown):
## 集聚分析与营销方向
| 客群 | 集聚区域 | 主体数 | 特征/主打 | 营销提示 |
|------|------|:--:|------|------|
| 企业 | XX工业园区/XX路 | N | 纺织/机械 | 园区批量走访、对公结算 |
| 商户 | 人民路商圈/XX集贸市场 | N | 餐饮/百货 | 收单、经营贷、流水贷 |
| 农户 | XX村/XX河种植带 | N | 合作社/家庭农场 | 惠农贷、种养大户授信 |
> 集聚分析基于已采集数据(POI 点位 + 注册地址),不额外消耗工商配额;若数据不足,用网络搜索补充区域产业分布信息并标注来源。
Step 6:行业协会/商会/专业市场检索
通过网络搜索(低资源)同步找出本地组织载体,供营销借力:
6.1 检索范围:
- 行业协会/商会:<县区> <产业> 行业协会、<县区> <产业> 商会、<乡镇> 商会(基层商会/镇商会)、<县区> 工商联 <产业>;提取名称、成立时间、会长/秘书长单位、会员数量、联系方式
- 专业市场:<乡镇> 市场、<县区> <产业> 批发市场、<乡镇> 集贸市场、<县区> <产业> 交易市场;提取名称、地址、主营品类、规模
- 产业联盟/农合联:<县区> 农民专业合作社联合社、<县区> 农合联、<县区> 家庭农场联盟
6.2 输出表(Markdown):
## 行业协会/商会/专业市场清单
| 类型 | 名称 | 简介 | 地址/规模 | 联系方式 | 营销价值 |
|------|------|------|------|------|------|
| 商会 | XX镇商会 | 会长XX/会员XX家 | 镇区 | 电话 | 批量获客渠道 |
| 专业市场 | XX集贸市场 | 主营XX/档口XX个 | 镇中心 | — | 商户集中地 |
6.3 营销价值标注:每个组织注明对营销的意义(如"商会=批量获客渠道""专业市场=商户集中地""合作社=惠农贷批量入口")。
Step 7:展示数据概况 + 分析结论,等待用户确认
采集与初步分析完成后展示摘要,等用户确认后再输出正式清单:
📊 数据获取结果(<乡镇>)
- 小微企业:XX 家(其中大中型/规上候选 X 家)
- 商户:XX 家(POI 三源合并)
- 农户(新型农业主体):XX 家(合作社X/家庭农场X/农业企业X)
- 集聚区域:企业→XX园区/XX路;商户→XX商圈/XX市场;农户→XX村
- 组织载体:行业协会/商会 X 家、专业市场 X 个
- 数据来源:天眼查/企查查/质数幻方/高德POI...
- 获取时间:YYYY-MM-DD HH:MM
Step 8:输出清单
默认输出:Markdown 摘要 + Excel 附件(分 Sheet:小微企业 / 商户 / 农户)+ 营销指引(集聚分析 + 协会商会)
- 文件命名:
<乡镇>_客群清单_YYYYMMDD.xlsx/<乡镇>_客群清单_YYYYMMDD.md - Excel 调用
scripts/generate_excel.py生成(三类客群各一个 Sheet) - 首行冻结、标题加粗、自动列宽(参照 street-merchant-list 样式)
- 集聚分析与协会商会清单并入 Markdown 报告(Step 5/6 输出)
Word 提示规则:交付前询问是否需要 Word 文档(.docx),确认后转换。
Step 9:联系方式(采集期同步获取,最后只补漏)
> v2.0 原则:联系方式不单独作为一轮——在 Step 4 采集清单时,凡接口能顺带返回电话/邮箱的(质数幻方 get_registration_info 一次返回完整照面+联系方式、百度 POI 带电话),采集的同时直接落库。Step 9 只处理剩余的缺口。
Step 9.1(默认执行):对 Step 4 穷举出的主体,凡缺联系方式的,用质数幻方 get_registration_info 逐家补齐(无每日配额限制,登记信息含电话/邮箱),或企查查 get_contact_info 补充;字段填"暂无"的保持空缺,不中断流程。
Step 9.2(仅经济强镇/市区街道):主体可能数百上千家,全量匹配消耗大——交付清单后询问匹配范围:
清单已生成(共 XX 家)。
是否需要全量匹配联系方式(电话/邮箱)?
⚠️ 主体较多时逐家匹配将消耗较多工商 API 配额(每家约1-2次调用)。
建议:优先匹配「大中型企业 + 农业主体」重点客群,小微商户可批量少量匹配。
请确认匹配范围:① 全部匹配 ② 仅重点客群 ③ 不匹配
输出规范(交付物)
| 交付物 | 格式 | 说明 |
|---|---|---|
| 客群清单 | Excel (.xlsx) | 三类客群分 Sheet,字段见上文 |
| 清单摘要 | Markdown(默认) | 数量统计 + 分布概况 |
| 集聚分析与营销方向 | Markdown(报告章节) | Step 5 输出:企业/商户/农户集中街区村社 + 营销提示 |
| 行业协会/商会/专业市场清单 | Markdown(报告章节) | Step 6 输出:组织载体 + 联系方式 + 营销价值 |
| 联系方式补充(可选) | 在 Excel 追加列 | 用户确认后才执行 |
信息来源附录:正文不逐段标注来源,文末统一列数据来源(编号引用制,参照 county-industry-research 输出规范)。
依赖与配置
| 依赖 | 用途 | 配置方式 |
|---|---|---|
openpyxl |
Excel 生成 | pip install openpyxl |
| 地图 POI(商户采集) | 商户清单 | 高德 AMAP_KEY / 腾讯 TENCENT_KEY(连接器用 TENCENT_MAP_KEY)/ 百度 BAIDU_AK 或 MCP 连接器;以第零步普查结果为准 |
| 工商数据(企业/农户) | 企业、农业主体清单 | 天眼查 tyc_tools CLI / 企查查 MCP(qcc-company)/ 质数幻方 MCP(yjidian-company);以第零步普查结果为准 |
| 网络搜索 | 补充核验、官方名录 | 内置能力 |
资源清单文件:references/local-resources.md——第零步普查后写入当前环境实际可用资源与调用方式;使用前先读此文件快速定位可用源。
多源并行原则:所有第零步确认可用的资源并行充分调用、各按其能力分工(不是简单的"降级链")——任一源配额不足时其余源继续尽力补足,全部用尽才如实说明覆盖率。
错误处理
| 情形 | 处理方式 |
|---|---|
| 乡镇重名/上级行政区不明 | 先向用户确认所属县区,再执行 |
| 商户 POI 为 0 | 如实告知,检查关键词/地图源,询问调整 |
| 某工商源配额不足 | 其余可用源继续尽力补足(不降级);全部用尽则告知覆盖率,仅交付已获取部分 |
| 新型农业主体检索无结果 | 检查是否用了合作社/家庭农场/农业关键词,或该乡镇农业主体确实少,如实说明 |
| 联系方式匹配失败 | 对应字段填"暂无",不中断流程 |
相关文件
- Excel 生成脚本:
scripts/generate_excel.py - 数据源与关键词指引:
references/data-guide.md - 输出模板:
references/output-template.md - 本地可用资源清单:
references/local-resources.md(第零步普查后写入,使用前先读)