# Zenserp — how to use (mcp.ai)

Connect your Zenserp account and use 12 tools for web scraping straight from your AI agent. Connect with your own API key. Zenserp is a real-time SERP API that extracts Google Search results in JSON format.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zenserp?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `zenserp_bing_search`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zenserp`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/zenserp/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zenserp/bing/search` — Tool to obtain Bing search results. Use when you need real-time scraping of Bing SERPs from bing.com.
  - body: { q: string, cc?: string, lat?: string, lon?: string, mkt?: string, count?: integer, first?: integer, location?: string, search_engine?: string }
- `POST https://api.mcp.ai/api/zenserp/get/shopping/product` — Tool to retrieve detailed Google Shopping product page information by product_id. Use when you need comprehensive product details including pricing, reviews, specifications, and seller information for
  - body: { gl?: string, hl?: string, location?: string, product_id: string, search_engine?: string }
- `POST https://api.mcp.ai/api/zenserp/get/status` — Tool to check the remaining API requests for your API key. Use when you need to verify your Zenserp API quota.
- `POST https://api.mcp.ai/api/zenserp/google/reverse/image/search` — Tool to perform a reverse image search on Google. Use after obtaining a public image URL to find where the image appears online.
  - body: { num?: integer, start?: integer, image_url: string }
- `POST https://api.mcp.ai/api/zenserp/google/search` — Tool to perform a standard Google search via Zenserp. Use when you need structured SERP data for a given query.
  - body: { q: string, gl?: string, hl?: string, lr?: string, lat?: number, lng?: number, num?: integer, tbm?: string, start?: integer, device?: string, output?: string, location?: string, timeframe?: string, search_engine?: string }
- `POST https://api.mcp.ai/api/zenserp/google/trends` — Tool to retrieve Google Trends data. Use when comparing keyword popularity over time.
  - body: { hl?: string, cat?: string, geo?: string, type?: string, keywords: string[], timeframe?: string }
- `POST https://api.mcp.ai/api/zenserp/list/batches` — Tool to list all submitted batches for your Zenserp API key. Use when you need to retrieve batch processing status or history.
- `POST https://api.mcp.ai/api/zenserp/list/countries` — Tool to get the list of supported Google country (gl) parameters. Use when you need to know valid country codes for geolocation.
- `POST https://api.mcp.ai/api/zenserp/list/languages` — Tool to get a list of supported Google interface language (hl) parameters. Use when you need to find valid language codes for Google search queries.
- `POST https://api.mcp.ai/api/zenserp/list/locations` — Tool to get a list of supported geo locations for search targeting. Use when you need to know which location parameters are available for geolocation queries.
- `POST https://api.mcp.ai/api/zenserp/list/search/engines` — Tool to get the list of supported search engines that can be queried via Zenserp. Use when you need to determine which search engine domains are available for searches.
- `POST https://api.mcp.ai/api/zenserp/yandex/search` — Tool to obtain Yandex search results via Zenserp API. Use when you need programmatic access to Yandex search data after constructing a query.
  - body: { q: string, gl?: string, hl?: string, num?: integer, tbm?: string, device?: string, location?: string, search_engine?: string }

## Example prompts
- "What can I do in Zenserp?"
- "Show me a summary of my Zenserp account"

## More
- Page: https://mcp.ai/zenserp
- Agent spec (llms.txt): https://mcp.ai/zenserp/llms.txt
- Postman collection: https://mcp.ai/zenserp/postman.json