Agent Skills
返回列表
🏢

跨境魔方地图商户搜索

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 规范拼装区域搜索参数