← Back to Skills Marketplace
baidu-maps-poi-ai-search
by
Archimondecy
· GitHub ↗
· v1.0.0
· MIT-0
140
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install baidu-maps-poi-ai-search
Description
Search and get details for POI (points of interest) using Baidu Maps API. Use for searching places, restaurants, hotels, attractions, and retrieving detailed...
README (SKILL.md)
Baidu Maps POI AI Search Skill
百度地图 POI AI搜索,通过百度地图AI搜接口，可以查找地点的名称、地址、类别、经营范围、属性内容。
⚠️ 环境配置：使用前请设置
BAIDU_AK环境变量（百度地图开放平台申请的 AK）。脚本内不含默认 AK，需自行配置。
接口概览
| 接口 | 脚本 | 说明 |
|---|---|---|
| 多维检索 | search.py |
搜索 POI，名称(北京大学)、地址(北京市上地十街10号)、类别(火锅)、经营范围(买包子)、复杂属性内容(西二旗附近适合带宠物的餐厅)。 |
1. 多维检索 (search.py)
python3 skills/baidu-maps-poi-ai-search/scripts/search.py '\x3CJSON>'
请求参数
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
| query | str | yes | - | 检索关键字，如"美食"、"海底捞"、"看日出的地方"、"能带宠物吃饭的餐厅" |
| region | str | yes | - | 行政区划，如"北京"、"北京市海淀区" |
| scope | int | yes | 2 | 2=详细信息 |
| page_num | int | no | 0 | 分页页码，从0开始 |
| center | str | no | - | 中心点坐标 lat,lng，配合 sort_name=distance |
| coord_type | int | no | 3 | 坐标类型：1=wgs84ll, 2=gcj02ll, 3=bd09ll |
多维检索 Examples
# 搜索名称
python3 skills/baidu-maps-poi-ai-search/scripts/search.py '{"query":"北京大学","region":"北京","scope":2,"page_size":5}'
# 搜索类别
python3 skills/baidu-maps-poi-ai-search/scripts/search.py '{"query":"火锅","region":"北京","scope":2,"page_size":5}'
# 口语化搜索
python3 skills/baidu-maps-poi-ai-search/scripts/search.py '{"query":"故宫附近能多人聚会的地方","region":"北京","scope":2,"page_size":5}'
API 文档
- 多维检索：
https://api.map.baidu.com/api_place_pro/v1/region
Usage Guidance
This skill appears to be what it claims: a Baidu Maps POI search helper. Before installing: 1) Ensure you supply a valid BAIDU_AK (the script will use the BAIDU_AK env var or an 'ak' field in the JSON call). Treat that key like any API credential — only give it to skills you trust. 2) The included Python script requires the 'requests' package; the skill does not install dependencies. 3) The script issues network calls to api.map.baidu.com (so the agent will contact Baidu when used). If you permit autonomous invocation, the agent could call the API (consuming quota and sending search queries). 4) Note minor implementation issues: the script prints parsed input to stderr (may appear in logs), and the output uses len() on a returned dict (may make the 'total' field misleading). If those are acceptable, the skill is coherent and reasonable to use.
Capability Analysis
Type: OpenClaw Skill
Name: baidu-maps-poi-ai-search
Version: 1.0.0
The skill is a legitimate implementation for searching Baidu Maps Points of Interest (POI). The script `scripts/search.py` correctly uses the `requests` library to query the official Baidu Maps API endpoint (api.map.baidu.com) using a user-provided API key (BAIDU_AK). There is no evidence of data exfiltration, malicious execution, or prompt injection in the code or documentation.
Capability Assessment
Purpose & Capability
Name/description say 'Baidu Maps POI search' and the skill requires BAIDU_AK and python3 and calls Baidu's place API endpoint. The requested env var (BAIDU_AK) is appropriate for the claimed purpose.
Instruction Scope
SKILL.md instructs calling the included Python script with a JSON payload. The script only reads the provided params and the BAIDU_AK (or 'ak' param) and sends requests to Baidu's API. It does not access unrelated files, secrets, or external endpoints beyond Baidu.
Install Mechanism
There is no install spec (instruction-only), but a Python script is included that imports the 'requests' library. The metadata requires python3 but does not declare the Python dependency (requests). Users will need to ensure 'requests' is available; the skill does not provide or install it.
Credentials
Only BAIDU_AK is required. That credential is directly needed to call Baidu's API; no unrelated credentials or sensitive paths are requested.
Persistence & Privilege
always is false and the skill does not attempt to modify agent/system configuration or persist credentials. It operates only when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install baidu-maps-poi-ai-search - After installation, invoke the skill by name or use
/baidu-maps-poi-ai-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of baidu-maps-poi-ai-search:
- Search for Points of Interest (POI) using the Baidu Maps API.
- Retrieve detailed POI info by name, address, category, or custom attributes.
- Supports searches for places, restaurants, hotels, and attractions.
- Requires configuration of the BAIDU_AK environment variable.
Metadata
Frequently Asked Questions
What is baidu-maps-poi-ai-search?
Search and get details for POI (points of interest) using Baidu Maps API. Use for searching places, restaurants, hotels, attractions, and retrieving detailed... It is an AI Agent Skill for Claude Code / OpenClaw, with 140 downloads so far.
How do I install baidu-maps-poi-ai-search?
Run "/install baidu-maps-poi-ai-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is baidu-maps-poi-ai-search free?
Yes, baidu-maps-poi-ai-search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does baidu-maps-poi-ai-search support?
baidu-maps-poi-ai-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created baidu-maps-poi-ai-search?
It is built and maintained by Archimondecy (@archimondecy); the current version is v1.0.0.
More Skills