跨境魔方地图商户搜索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/upkuajing-upkuajing-map-merchants-search-zh-104。
技能介绍
要解决的问题
出海或本地拓客时,你往往手里只有关键词和大致地理范围,却需要从地图类商户库里拉出可跟进的公司名单,还要能按行业、是否有电话/网站、店铺名称等条件缩小结果。手工在地图上点选不可复制、不可批量,也不方便和 CRM 或外呼流程对接。
技能如何工作
本技能通过跨境魔方开放平台访问地图商户数据,核心分两块:
merchants_search.py:商户搜索,支持区域搜索(国家/州省/城市 + 关键词与筛选)与附近搜索(geoDistance经纬度 + 半径,如5km)。geography_list.py:拉取国家/省/市层级 ID,用于先解析位置再拼搜索参数。
典型流程是:用地理列表拿到 countryCodes、provinceIds 或 cityIds → 组合英文关键词与 industries、existPhone、existWebsite、companyNames 等过滤器 → 直接调用 python scripts/merchants_search.py(勿用 cd scripts && ... 复合命令)。大规模查询可用 --task_id 恢复中断任务,减少重复计费。执行前应对照 references/merchants-search-api.md,不要猜测参数名;国家代码用 ISO 3166-1 alpha-2(如 CN、US)。
边界与注意点
- 商户搜索按调用次数计费,每轮最多 100 条;
query_count > 100时需先说明预计调用次数并等用户明确确认后再跑脚本。地理列表查询免费。 - API 密钥存于
~/.upkuajing/.env的UPKUAJING_API_KEY;余额不足需走充值流程。助手中勿用代码块堆砌技术参数,应对用户说成自然语言;定价以auth.py --price_info为准,勿自行估算。
使用场景
- 拓展拉美某国代理渠道时,按国家代码和英文行业关键词批量导出带官网的地图商户清单
- 线下展会前,以展馆经纬度设置 3~5km 半径,筛出有电话的周边门店用于拜访排序
- 已知目标连锁品牌店名,用 companyNames 在指定城市 ID 内核对地图上登记的分店数量
- 区域搜索中途断线后,用上次返回的 task_id 续跑大规模 query_count 而不重复扣费
适合人员
- 负责海外线下渠道开发的 BD,需要按国家/城市拉地图商户并筛电话或网站
- 跨境电商运营,要在某商圈半径内找可合作的实体门店或服务商名单
- 市场研究员,需要把地图 POI 商户数据与行业、店名条件对齐后做竞品分布统计
- 已接入跨境魔方 API 的数据运营,需用地理列表 ID 规范拼装区域搜索参数