OneKey Gateway
Use One Access Key to connect to various commercial APIs. Please visit the
OneKey Gateway Keys and read the docs
OneKey MCP Router Doc and
OneKey Gateway Doc.
Dependencies
Install the required Python package before running any scripts.
CODEBLOCK0
Alternatively, install dependencies from the requirements file:
CODEBLOCK1
If the package is already installed, skip installation.
Agent rule
Before executing any script in the scripts/ directory, ensure the dependencies are installed.
amap-maps-streamableHTTP Skill
Use the OneKey Gateway to access tools for this server via a unified access key.
Quick Start
Set your OneKey access key:
export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_API_KEY
If no key is provided, the scripts fall back to the demo key
BETA_TEST_KEY_MARCH_2026.
Common settings:
- -
unique_id: INLINECODE2 - INLINECODE3 : one of the tools listed below
Tools
maps_direction_bicycling
骑行路径规划用于规划骑行通勤方案，规划时会考虑天桥、单行线、封路等情况。最大支持 500km 的骑行路线规划
Parameters:
- -
origin (string, required): 出发点经纬度，坐标格式为：经度，纬度 - INLINECODE6 (string, required): 目的地经纬度，坐标格式为：经度，纬度
maps_direction_driving
驾车路径规划 API 可以根据用户起终点经纬度坐标规划以小客车、轿车通勤出行的方案，并且返回通勤方案的数据。
Parameters:
- -
origin (string, required): 出发点经纬度，坐标格式为：经度，纬度 - INLINECODE9 (string, required): 目的地经纬度，坐标格式为：经度，纬度
maps_direction_transit_integrated
根据用户起终点经纬度坐标规划综合各类公共（火车、公交、地铁）交通方式的通勤方案，并且返回通勤方案的数据，跨城场景下必须传起点城市与终点城市
Parameters:
- -
origin (string, required): 出发点经纬度，坐标格式为：经度，纬度 - INLINECODE12 (string, required): 目的地经纬度，坐标格式为：经度，纬度
- INLINECODE13 (string, required): 公共交通规划起点城市
- INLINECODE14 (string, required): 公共交通规划终点城市
maps_direction_walking
根据输入起点终点经纬度坐标规划100km 以内的步行通勤方案，并且返回通勤方案的数据
Parameters:
- -
origin (string, required): 出发点经度，纬度，坐标格式为：经度，纬度 - INLINECODE17 (string, required): 目的地经度，纬度，坐标格式为：经度，纬度
maps_distance
测量两个经纬度坐标之间的距离,支持驾车、步行以及球面距离测量
Parameters:
- -
origins (string, required): 起点经度，纬度，可以传多个坐标，使用竖线隔离，比如120,30|120,31，坐标格式为：经度，纬度 - INLINECODE20 (string, required): 终点经度，纬度，坐标格式为：经度，纬度
- INLINECODE21 (string, optional): 距离测量类型,1代表驾车距离测量，0代表直线距离测量，3步行距离测量
maps_geo
将详细的结构化地址转换为经纬度坐标。支持对地标性名胜景区、建筑物名称解析为经纬度坐标
Parameters:
- -
address (string, required): 待解析的结构化地址信息 - INLINECODE24 (string, optional): 指定查询的城市
maps_regeocode
将一个高德经纬度坐标转换为行政区划地址信息
Parameters:
- -
location (string, required): 经纬度
maps_ip_location
IP 定位根据用户输入的 IP 地址，定位 IP 的所在位置
Parameters:
- -
ip (string, required): IP地址
maps_schema_personal_map
用于行程规划结果在高德地图展示。将行程规划位置点按照行程顺序填入lineList，返回结果为高德地图打开的URI链接，该结果不需总结，直接返回！
Parameters:
- -
orgName (string, required): 行程规划地图小程序名称 - INLINECODE31 (array of object, required): 行程列表
- INLINECODE32 (string, required): 行程名称描述（按行程顺序）
- INLINECODE33 (array of object, required): 行程目标位置点描述
- INLINECODE34 (string, required): 行程目标位置点名称
- INLINECODE35 (number, required): 行程目标位置点经度
- INLINECODE36 (number, required): 行程目标位置点纬度
- INLINECODE37 (string, required): 行程目标位置点POIID
maps_around_search
周边搜，根据用户传入关键词以及坐标location，搜索出radius半径范围的POI
Parameters:
- -
keywords (string, required): 搜索关键词 - INLINECODE40 (string, required): 中心点经度纬度
- INLINECODE41 (string, optional): 搜索半径
- INLINECODE42 (integer, optional): 召回策略，0=默认召回策略，1=优先召回扫街榜POI
maps_search_detail
查询关键词搜或者周边搜获取到的POI ID的详细信息
Parameters:
- -
id (string, required): 关键词搜或者周边搜获取到的POI ID
maps_text_search
关键字搜索 API 根据用户输入的关键字进行 POI 搜索，并返回相关的信息
Parameters:
- -
keywords (string, required): 查询关键字 - INLINECODE47 (string, optional): 查询城市
- INLINECODE48 (boolean, optional): 是否限制城市范围内搜索，默认不限制
maps_schema_navi
Schema唤醒客户端-导航页面，用于根据用户输入终点信息，返回一个拼装好的客户端唤醒URI，用户点击该URI即可唤起对应的客户端APP。唤起客户端后，会自动跳转到导航页面。
Parameters:
- -
lon (string, required): 终点经度 - INLINECODE51 (string, required): 终点纬度
maps_schema_take_taxi
根据用户输入的起点和终点信息，返回一个拼装好的客户端唤醒URI，直接唤起高德地图进行打车。直接展示生成的链接，不需要总结
Parameters:
- -
slon (string, optional): 起点经度 - INLINECODE54 (string, optional): 起点纬度
- INLINECODE55 (string, optional): 起点名称
- INLINECODE56 (string, required): 终点经度
- INLINECODE57 (string, required): 终点纬度
- INLINECODE58 (string, required): 终点名称
maps_weather
根据城市名称或者标准adcode查询指定城市的天气
Parameters:
- -
city (string, required): 城市名称或者adcode
Usage
CLI
mapsdirectionbicycling
CODEBLOCK3
mapsdirectiondriving
CODEBLOCK4
mapsdirectiontransit_integrated
CODEBLOCK5
mapsdirectionwalking
CODEBLOCK6
maps_distance
CODEBLOCK7
maps_geo
CODEBLOCK8
maps_regeocode
CODEBLOCK9
mapsiplocation
CODEBLOCK10
mapsschemapersonal_map
CODEBLOCK11
mapsaroundsearch
CODEBLOCK12
mapssearchdetail
CODEBLOCK13
mapstextsearch
CODEBLOCK14
mapsschemanavi
CODEBLOCK15
mapsschematake_taxi
CODEBLOCK16
maps_weather
CODEBLOCK17
Scripts
Each tool has a dedicated script in this folder:
- - INLINECODE61
- INLINECODE62
- INLINECODE63
- INLINECODE64
- INLINECODE65
- INLINECODE66
- INLINECODE67
- INLINECODE68
- INLINECODE69
- INLINECODE70
- INLINECODE71
- INLINECODE72
- INLINECODE73
- INLINECODE74
- INLINECODE75
Example
CODEBLOCK18
Related DeepNLP OneKey Gateway Documents
AI Agent Marketplace
Skills Marketplace
AI Agent A2Z Deployment
PH AI Agent A2Z Infra
GitHub AI Agent Marketplace
Dependencies
CLI Dependency
Install onekey-gateway from npm
CODEBLOCK19
Script Dependency
Install the required Python package before running any scripts.
CODEBLOCK20
Alternatively, install dependencies from the requirements file:
CODEBLOCK21
If the package is already installed, skip installation.
Agent rule
Before executing command lines or running any script in the scripts/ directory, ensure the dependencies are installed.
Use the
onekey CLI as the preferred method to run the skills.
