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.

export $DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

Get your OneKey access key at Access Key

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¶

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	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	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	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	bing-image-search-mcp	search_images search_images_batch
Web Search	brave-search/brave-search Doc	brave-search	brave_local_search brave_web_search
Web Search	google-search/google-search Doc	google-search	google_search
Web Search	tavily-remote-mcp/tavily-remote-mcp Doc	tavily-remote-mcp	tavily_crawl tavily_extract tavily_map tavily_research tavily_search
Web Crawl / Browser	firecrawl-mcp/firecrawl-mcp Doc	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	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	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	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	perplexity	perplexity_ask perplexity_reason perplexity_research perplexity_search
3D Generation	craftsman-agent/craftsman-agent Doc	craftsman-agent	generate_lego_build_plan generate_minecraft_build_plan

Example 1: Google Maps Search¶

onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'

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