## DeepNLP OneKey Agent Router to Access Various AI Agents in AI Agent Marketplace
OneKey AI Agent Router is an proxy service which support skills, cli, and APIs of AI Agent services.
## OneKey Agent Router
### Quickstart
**Base URL**
- https://agent.deepnlp.org/agent_router
**Request**
Request Header
- `X-OneKey`: Header value for authentication
Request Body
- `unique_id`: The unique id of agents api to route, follows the github "owner_id/repo_name" format.
- `api_id`: The API IDs for Agent Router to calls
- `data`: The json payload post to the agent API.
**Example Usage**
Let's use a Google Maps search places agent apis as an example.
```angular2html
export $DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
```
Get your OneKey access key at [Access Key](https://www.deepnlp.org/workspace/keys)
#### maps_search_places
Description: Search for places using Google Places API
## Parameters
- query: string — Search query
- location: object — Optional center point for the search
- radius: number — Search radius in meters (max 50000)
##### CLI
```
onekey agent google-maps/google-maps maps_search_places '{"query": "Italian restaurants", "location": {"latitude": 40.758, "longitude": -73.9855}, "radius": 500}'
```
##### RESTFUL
```
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
curl -v -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{"unique_id":"google-maps/google-maps","api_id":"maps_search_places","data":{"query": "Italian restaurants", "location": {"latitude": 40.758, "longitude": -73.9855}, "radius": 500}}'
```
##### MCP
```
onekey mcp google-maps
```
Add to client config
```
{
"mcpServers":{
"deepnlp-onekey-google-maps":{
"url":"https://agent.deepnlp.org/mcp?server_name=google-maps&onekey=${DEEPNLP_ONEKEY_ROUTER_ACCESS}"
}
}
}
```
##### Skills
```
npx agtm add aiagenta2z/onekey-gateway --skill google-maps -g
npx skills add https://github.com/aiagenta2z/onekey-gateway --skill google-maps
```
##### python/typescript
```python
from ai_agent_marketplace import OneKeyAgentRouter
import os
router = OneKeyAgentRouter(onekey=os.getenv('DEEPNLP_ONEKEY_ROUTER_ACCESS','BETA_TEST_KEY_MARCH_2026'))
router.invoke(unique_id="google-maps/google-maps", api_id="maps_search_places", data={"query": "Italian restaurants", "location": {"latitude": 40.758, "longitude": -73.9855}, "radius": 500})
```
## OneKey Gateway Categories
You can find the detail CLI, REST, MCP, Skills Usage in the respective documents.
## Gateway Categories
| Domain | Unique Id | Skill ID | API ID |
|----------------------|--------------------------------------------------------------------------------------------------------------|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Map (Google) | google-maps/google-maps [Doc](./onekey-gateway/google-maps/README.md) | google-maps | maps_directions
maps_distance_matrix
maps_elevation
maps_geocode
maps_place_details
maps_reverse_geocode
maps_search_places |
| Map (Amap/Gaode Map) | amap-maps-streamableHTTP/amap-maps-streamableHTTP [Doc](./onekey-gateway/amap-maps-streamableHTTP/README.md) | amap-maps-streamableHTTP | maps_around_search
maps_direction_bicycling
maps_direction_driving
maps_direction_transit_integrated
maps_direction_walking
maps_distance
maps_geo
maps_ip_location
maps_regeocode
maps_schema_navi
maps_schema_personal_map
maps_schema_take_taxi
maps_search_detail
maps_text_search
maps_weather |
| Map (Baidu) | baidu-maps-sse/baidu-maps-sse [Doc](./onekey-gateway/baidu-maps-sse/README.md) | baidu-maps-sse | maps_directions
maps_distance_matrix
maps_elevation
maps_geocode
maps_place_details
maps_reverse_geocode
maps_search_places |
| Image Search | bing-image-search-mcp/bing-image-search-mcp [Doc](./onekey-gateway/bing-image-search-mcp/README.md) | bing-image-search-mcp | search_images
search_images_batch |
| Web Search | brave-search/brave-search [Doc](./onekey-gateway/brave-search/README.md) | brave-search | brave_local_search
brave_web_search |
| Web Search | google-search/google-search [Doc](./onekey-gateway/google-search/README.md) | google-search | google_search |
| Web Search | tavily-remote-mcp/tavily-remote-mcp [Doc](./onekey-gateway/tavily-remote-mcp/README.md) | tavily-remote-mcp | tavily_crawl
tavily_extract
tavily_map
tavily_research
tavily_search |
| Web Crawl / Browser | firecrawl-mcp/firecrawl-mcp [Doc](./onekey-gateway/firecrawl-mcp/README.md) | firecrawl-mcp | firecrawl_agent
firecrawl_agent_status
firecrawl_browser_create
firecrawl_browser_delete
firecrawl_browser_execute
firecrawl_browser_list
firecrawl_check_crawl_status
firecrawl_crawl
firecrawl_extract
firecrawl_map
firecrawl_scrape
firecrawl_search |
| Image Generation | gemini/gemini [Doc](./onekey-gateway/gemini/README.md) | gemini (Nano Banana) | generate_image_gemini
generate_image_nano_banana
generate_image_nano_banana_with_reference
ocr_extract_text_from_image
list_items_from_image |
| Image Generation | gemini-nano-banana/gemini-nano-banana [Doc](./onekey-gateway/gemini-nano-banana/README.md) | gemini-nano-banana | generate_image_gemini
generate_image_nano_banana
generate_image_nano_banana_with_reference
ocr_extract_text_from_image
list_items_from_image |
| Charts | mcp-server-chart/mcp-server-chart [Doc](./onekey-gateway/mcp-server-chart/README.md) | mcp-server-chart | generate_area_chart
generate_bar_chart
generate_boxplot_chart
generate_column_chart
generate_district_map
generate_dual_axes_chart
generate_fishbone_diagram
generate_flow_diagram
generate_funnel_chart
generate_histogram_chart
generate_line_chart
generate_liquid_chart
generate_mind_map
generate_network_graph
generate_organization_chart
generate_path_map
generate_pie_chart
generate_pin_map
generate_radar_chart
generate_sankey_chart
generate_scatter_chart
generate_spreadsheet
generate_treemap_chart
generate_venn_chart
generate_violin_chart
generate_waterfall_chart
generate_word_cloud_chart |
| Research QA | perplexity/perplexity [Doc](./onekey-gateway/perplexity/README.md) | perplexity | perplexity_ask
perplexity_reason
perplexity_research
perplexity_search |
| 3D Generation | craftsman-agent/craftsman-agent [Doc](./onekey-gateway/craftsman-agent/README.md) | craftsman-agent | generate_lego_build_plan
generate_minecraft_build_plan |
#### Example 1: Google Maps Search
```bash
onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
```
```bash
curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
"unique_id": "google-maps/google-maps",
"api_id": "maps_search_places",
"data": {
"query": "New York City Italian Restaurants"
}
}'
```
#### Example 2: Image Generation
model:
- gemini-3-pro-image-preview
- gemini-2.5-flash-image
```
onekey agent gemini-nano-banana/gemini-nano-banana generate_image_gemini '{"model":"gemini-2.5-flash-image", "prompt":"Generate a minecraft scene of steve fighting zombies in purple crystal fields."}'
```
```
{"success":true,"data":"[\"{\\n \\\"image_path\\\": \\\"/data/python/mcp_tool_use/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n \\\"image_url\\\": \\\"https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png\\\",\\n \\\"message\\\": \\\"\\\",\\n \\\"success\\\": true\\n}\"]","error":null}
## Return Image url:
https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f61-5c0a6744cab0/gemini_output_images.png
```