baidu-maps-poi-ai-search

What This Skill Does

The baidu-maps-poi-ai-search skill enables your OpenClaw agent to interact directly with the Baidu Maps API, providing powerful geospatial search capabilities. It interprets natural language queries to identify points of interest (POIs) such as businesses, restaurants, hotels, or scenic spots within a specified administrative region. Beyond simple keyword matching, it leverages advanced semantic search to interpret context-heavy requests like 'best places to walk dogs' or 'quiet coffee shops for meetings' in a target city. The skill returns rich metadata, including addresses, business categories, and detailed location profiles, making it an essential tool for location-based planning and data discovery tasks.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/archimondecy/baidu-maps-poi-ai-search

After installation, you must configure the environment variable BAIDU_AK with your personal Access Key obtained from the Baidu Maps Open Platform. Ensure this key is properly exported in your shell profile or local execution environment to allow the scripts to communicate with the Baidu API endpoints successfully.

Use Cases

• Travel Planning: Quickly locate hotels and top-rated attractions in specific cities to generate itineraries.
• Market Research: Analyze the density and distribution of specific business categories (e.g., 'coffee shops' or 'gyms') in a given region to assist with business location strategies.
• Personalized Recommendations: Help users find unique spots based on specific requirements, such as family-friendly restaurants or venues suitable for large group gatherings.
• Logistics and Routing: Obtain specific coordinates to assist with calculating distances or planning optimal travel paths between multiple points of interest.

Example Prompts

• 'Find five highly-rated Italian restaurants in downtown Shanghai.'
• 'I am looking for pet-friendly parks in Haidian District, Beijing.'
• 'List all major public museums near the Palace Museum and provide their addresses.'

Tips & Limitations

• Accuracy: Always provide a specific 'region' parameter to ensure the search scope remains focused, as overly broad queries may yield irrelevant results.
• Dependencies: The skill requires a valid Baidu API Access Key; if the quota is exceeded, requests will fail. Monitor your daily request limits via the Baidu developer portal.
• Data Freshness: POI information is retrieved from Baidu's live database; while highly reliable, it reflects the latest data uploaded to the Baidu platform. Ensure your network has access to api.map.baidu.com.