What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Google Maps business data extraction paired with bulk search and batch data download capabilities for global B2B lead generation. Filter search results bycountry, state, city, district, search radius, industry and product keywords to batch collect busines

Pull bulk Google Maps business data with radius‑based filters. Gather merchant contact information, analyze market density and find distributors or overseas buyers for offline business expansion. Trigger: Google maps business scraper, bulk merchant data download, radius‑based lead search, distributor sourcing, competitor store analysis, regional market research, offline sales‑lead generation

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.9k

Updated

Oct 9, 2026

Version

1.0.6

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 1.9K downloadsadoption · observed Oct 9, 2026
Latest release: 1.0.6release · observed Aug 24, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:upkuajing-map-merchants-search

Install using `clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:upkuajing-map-merchants-search` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/upkuajing/upkuajing-map-merchants-search before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-upkuajing-map-merchants-search/snapshot"

Documentation

CLAWHUB

103,002 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: upkuajing-map-merchants-search
description: "Pull bulk Google Maps business data with radius‑based filters. Gather merchant contact information, analyze market density and find distributors or overseas buyers for offline business expansion.\n\nTrigger: Google maps business scraper, bulk merchant data download, radius‑based lead search, distributor sourcing, competitor store analysis, regional market research, offline sales‑lead generation"
metadata: {"version":"1.0.6","homepage":"https://www.upkuajing.com","clawdbot":{"emoji":"📍","requires":{"bins":["python"],"env":["UPKUAJING_API_KEY"]},"primaryEnv":"UPKUAJING_API_KEY"}}
---

# UpKuaJing Map Merchants Search

Query merchant information using the UpKuaJing Open Platform API. This skill provides map-based merchant search with two search modes: region search and nearby search.

## Overview

This skill provides access to UpKuaJing's map merchant database through:
- **Merchants Search** (`merchants_search.py`): Search merchants by keywords and location
- **Geography List** (`geography_list.py`): Get country/province/city lists for location parameters

## Running Scripts

### Environment Setup

1. **Check Python**: `python --version`
2. **Install dependencies**: `pip install -r requirements.txt`

Script directory: `scripts/*.py`
Run example: `python scripts/*.py`

**Important**: Always use direct script invocation like `python scripts/merchants_search.py`. **Do NOT use** shell compound commands like `cd scripts && python merchants_search.py`.

## Two Main APIs

### Merchant Search (`merchants_search.py`)

Search merchants by keywords and geographic area.

**Parameters**: See [Merchants Search API](references/merchants-search-api.md)

**Two Search Modes**:
- **Country Search**: Search by country/province/city, keywords, and filters
- **Nearby Search**: Search by latitude/longitude and radius using `geoDistance`

**Examples**:
```bash
# Country search - Find restaurants in Brazil
python scripts/merchants_search.py \
  --params '{"keywords":["restaurant"],"countryCodes":["BR"]}' \
  --query_count 100

# Multi-country search with phone filter - Find restaurants in US or China with phone
python scripts/merchants_search.py \
  --params '{"keywords":["restaurant"],"countryCodes":["US","CN"],"existPhone":true}' \
  --query_count 50

# Industry filter - Find car dealers in Thailand
python scripts/merchants_search.py \
  --params '{"keywords":["car dealer"],"countryCodes":["TH"],"industries":["Cars"]}' \
  --query_count 100

# Nearby search - Find hotels within 5km of a point
python scripts/merchants_search.py \
  --params '{"keywords":["hotel"],"geoDistance":{"location":{"lat":31.1104643,"lon":29.7602221},"distance":"5km"}}'

# Province and city filter - Find restaurants in a specific province/city
python scripts/merchants_search.py \
  --params '{"keywords":["restaurant"],"provinceIds":["2277"],"cityIds":["19975"]}' \
  --query_count 50

# Shop name filter - Find shops by specific name
python scrip

_meta.json

{
  "ownerId": "kn76ywjzma121r2rh959ejsf49834c6x",
  "slug": "upkuajing-map-merchants-search",
  "version": "1.0.6",
  "publishedAt": 1787562692267
}

references/city-list-api.md

# 城市列表 API 参考

## python脚本参数
- `--type`：地理类型（固定为 city）
- `--country_id`：国家ID（必需）

## 响应数据

### 城市信息
- id：城市ID
- nameEn：英文名
- name：名字

references/country-list-api.md

# 国家列表 API 参考

## python脚本参数
- `--type`：地理类型（固定为 country）

## 响应数据

### 国家信息
- id：国家ID
- area：地区
- code：国家二字码
- icon：国旗图标URL
- nameEn：国家英文名
- name：国家名

references/merchants-search-api.md

# 商户列表搜索 API 参考

## python脚本参数
- `--params`：搜索参数JSON字符串
- `--task_id`：任务ID（断点续查用）
- `--query_count`：期望获取的总记录数（非必填，默认20）

## 请求参数 (params JSON)

### 核心参数
- `keywords`：搜索词列表（JSON数组）
- `keywordsFilter`：过滤关键词列表（JSON数组）
- `countryCodes`：国家二字码列表（JSON数组，如["CN", "US"]）
- `countryCodesFilter`：过滤二字码列表（JSON数组）
- `provinceIds`：省份ID列表（JSON数组）
- `cityIds`：城市ID列表（JSON数组）
- `companyNames`：店铺名称列表（JSON数组）
- `industries`：行业名称列表（JSON数组）
- `existPhone`：存在电话筛选（boolean，true=只返回有电话的商户）
- `existWebsite`：存在网址筛选（boolean，true=只返回有网址的商户）
- `cursor`：搜索游标（分页用）

### 坐标查询（附近搜索）
- `geoDistance.location.lat`：纬度
- `geoDistance.location.lon`：经度
- `geoDistance.distance`：搜索半径（如"5km"）

## 响应数据

### 商户标识
- companyId：公司ID
- name：名称
- industry：行业

### 地址信息
- country：国家名称
- countryIsoCode：国家二字码
- provinceName：省份名称
- provinceId：省份ID
- cityName：城市名称
- cityId：城市ID
- addressDetail：详细地址
- postcode：邮编

### 坐标信息
- location.lat：纬度
- location.lon：经度

Github ReposUpdated 11h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.