An intelligent map data extraction tool that resolves city coordinates, translates search criteria, and streams localized business listings.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install topeasymapsearch
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install topeasymapsearch using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Topeasy Map Search?
The topeasy-map-search skill is a highly optimized, automated data-gathering utility built for modern AI agents. Operating as an extension of the Openclaw Skills framework, this tool allows developers and analysts to easily retrieve localized business directories, geographic intelligence, and competitive market data. By utilizing natural language processing, the agent extracts target city parameters and search criteria directly from user commands, seamlessly resolving localized language barriers and geographical coordinate lookups.
Rather than forcing users to manually query maps, geocode coordinates, or manage complicated map API requests, the backend engine delegates spatial resolution directly to the AI. Once geographic bounds are resolved, a background node execution retrieves and delivers structured files filled with targeted spatial datasets, perfect for immediate analytics or contextual processing.
Topeasy Map Search Use Cases
- Localized Market Mapping: Analyze local business ecosystems, assessing the presence and concentration of regional target niches.
- Hyper-Targeted B2B Lead Generation: Automate list building for sales development reps aiming to penetrate specific geographical boundaries.
- Geographic Coverage Validation: Conduct sanity checks on company geographic visibility and directory presence within localized regions.
- Dynamic Market Expansion Surveys: Assess target locations in new countries by querying local directory densities directly from an AI terminal.
How Topeasy Map Search Works
- Context Extraction: The AI reviews input text to parse out the target city name and search keywords.
- Internal Translation: If user search parameters are entered in a foreign language like Chinese, the AI maps and translates them into English query terms.
- Coordinate Lookup: The AI consults a coordinate library or leverages semantic knowledge to determine the approximate latitude and longitude of the target city.
- Background Data Retrieval: The skill triggers a background subprocess executing
node ./scripts/fetch_stream.jsalongside the coordinates and keyword parameters. - Analytical Presentation: The downloaded raw JSON database is parsed, summarized, and presented to the user with actionable business evaluations and quality statistics.
Topeasy Map Search Setup
Integrating topeasy-map-search into your Openclaw Skills workflow is straightforward. Ensure your target workspace supports Node.js executions.
Running Search Executions
Submit the search instruction format directly to your agent interface:
/topeasy-map-search "London" "organic food market"
Authentication and Quota Settings
If you run into authorization issues during data pipeline executions, ensure your credentials are set up properly:
- STATUS:401: Missing or invalid skill key. Verify your environment keys.
- STATUS:402: Free tier consumption limits reached. Top up your account credentials at
https://www.oraskl.com/agentskillto resume query tasks.
Topeasy Map Search Data Schema & Taxonomy
The skill manages input query transformations and generates structured local data objects.
Parameter Schema
| Parameter | Source | Type | Description |
|---|---|---|---|
city |
User Input | String | Target metropolitan location (e.g., Tokyo, Paris) |
keyword |
User Input | String | Niche vertical or business focus (e.g., gym, bakery) |
latitude |
AI Evaluated | Float | Calculated latitude coordinate of the city |
longitude |
AI Evaluated | Float | Calculated longitude coordinate of the city |
Output Output Objects
| Object | Format | Description |
|---|---|---|
task_id |
String | Unique tracking ID of the streaming fetch script |
file_path |
File Path | Location path to raw retrieved JSON records |
business_insights |
Text/Markdown | Contextual summary assessing listing quality and densities |
Topeasy Map Search Advanced Features
- Autonomous AI Translation: Converts localization terms automatically into high-performing target database languages without relying on external dictionary APIs.
- Zero-Dependency Geocoding: Leverages structural LLM positioning weights to map location strings directly into latitude and longitude inputs.
- Asynchronous Task Hooking: Employs non-blocking background streaming parameters (
run_in_background) allowing developers to execute extensive data mining scripts over long horizons. - Context Window Protection: Enforces strict payload validation rules limiting searches to single query scopes to guarantee system performance and control context consumption.
SKILL.md
Loading
Related Openclaw Skills
Customs Data Analysis Expert
An advanced AI-powered customs intelligence skill that automates multi-dimensional trade data analytics, logistics auditing, and supplier discoveries.
AI Contract Review Master
An intelligent AI agent skill that delivers top-tier legal contract auditing, risk mitigation, and compliance checks across multiple jurisdictions and languages.
Global Product Selection Radar
An AI-driven product selection and competitor intelligence radar covering 15+ domestic and global e-commerce platforms.
Short Video Viral Factory
An AI-powered viral video script engine designed to optimize short-form video content and strategy across major social platforms.
Second Brain Builder
An AI agent skill designed to compile research, map intellectual lineages, and organically write back precise concept pages to your local second brain.
I Contain Multitudes - Microbial Science Assistant
An interactive AI assistant skill built on Ed Yong's 'I Contain Multitudes' to explore the biology of the microbiome and host-microbe symbiosis.
Featured*
