街道商户清单生成器

简介

根据城市名称和街道名称，自动采集该区域内所有商户信息，生成按门牌号排序的 Excel 清单。

功能特性

• 双模式查询：街道模式（单街道）和区域模式（中心点+半径）
• 三源数据：高德地图、腾讯地图、百度地图
• 智能去重：100%相同合并，80-99%相似标注"可能重复"
• 门牌号排序：按门牌号升序排列，无门牌号按经纬度排序
• 防幻觉机制：API数据优先，明确标注数据来源

安装依赖

pip install requests openpyxl

使用方法

街道模式

cd scripts
python main.py --mode street --city 上海 --street 南京东路 --output ./output

区域模式

python main.py --mode area --city 上海 --center 人民广场 --radius 3 --output ./output

Python 调用

from main import StreetMerchantListGenerator

generator = StreetMerchantListGenerator()

# 街道模式
file_path = generator.generate_street_list('上海', '南京东路', './output')

# 区域模式
file_path = generator.generate_area_list('上海', '人民广场', 3, './output')

文件结构

street-merchant-list/
├── SKILL.md              # Skill 定义
├── README.md             # 使用说明
├── scripts/
│   ├── main.py           # 主流程入口
│   ├── api_clients/      # API 客户端
│   │   ├── amap_client.py
│   │   ├── tencent_client.py
│   │   └── baidu_client.py
│   ├── data_processor.py # 数据处理
│   ├── web_searcher.py   # 网络搜索补充
│   └── excel_generator.py # Excel 生成

API Keys

在使用前需要配置 API Keys：

export AMAP_KEY='你的高德Key'
export TENCENT_KEY='你的腾讯Key'
export BAIDU_AK='你的百度AK'

或在代码中直接设置：

import os
os.environ['AMAP_KEY'] = '你的Key'

Excel 输出字段

| 列名 | 说明 | |------|------| | 序号 | 1, 2, 3... | | 门牌号 | 提取的门牌号 | | 商户名称 | 正式名称 | | 业态大类 | 购物/餐饮/住宿等 | | 业态细分 | 更精确分类 | | 完整地址 | 原始地址 | | 经度 | GPS坐标 | | 纬度 | GPS坐标 | | 数据来源 | 高德/腾讯/百度 | | 备注 | 可能重复/无门牌号 |

注意事项

1. 腾讯地图 IP 白名单：需在控制台配置当前 IP
2. 免费配额：高德/腾讯/百度均有免费额度，通常足够使用
3. 数据覆盖：约 60-80% 商户有明确门牌号
4. 网络搜索：AI 补充的数据会标注"需人工复核"

更新日志

v1.0.0 (2026-03-27)

• 初始版本
• 支持高德/腾讯/百度三源数据采集
• 支持街道模式和区域模式