# Piloterr — how to use (mcp.ai)

Connect your Piloterr account and use 12 tools for web scraping straight from your AI agent. Connect with your own API key. Piloterr is a developer-first platform offering over 50 ready-to-use APIs for web scraping and data extraction, enabling businesses to efficiently gather and integrate web data into their systems.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_piloterr?ms=1787293680000`
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. `piloterr_auchan_product`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/piloterr`
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/piloterr/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/piloterr/auchan/product` — Tool to retrieve detailed Auchan product information. Use when you have an Auchan product URL.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/auchan/search` — Tool to search for products on Auchan by query or search URL. Use when you need product listings and details from Auchan.
  - body: { page?: integer, query: string }
- `POST https://api.mcp.ai/api/piloterr/get/product/info` — Tool to retrieve detailed product information from G2. Use when you need full product details including ratings, reviews, pricing, and company info. Accepts a product name or G2 URL as query.
  - body: { query: string, nps_score?: integer }
- `POST https://api.mcp.ai/api/piloterr/list/chewy/products` — Tool to find Chewy product categories by search query. Use when you need to retrieve Chewy product URLs and details based on product ID or title.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/list/eleclerc/stores` — Tool to find E.Leclerc store locations by search query. Use when you need to locate E.Leclerc stores in a specific area or city.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/list/google/countries` — Tool to list available Google search countries. Use when you need to find country codes for Google search localization.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/list/google/languages` — Tool to list available Google search languages filtered by query. Use when you need to find specific language codes for Google searches.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/list/google/locations` — Tool to list available Google search locations via Piloterr API. Use when you need to find location identifiers for geographically-targeted searches.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/list/leroy/merlin/products` — Tool to list Leroy Merlin product categories. Use when you need to search for Leroy Merlin products by name or identifier.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/list/linked/in/industries` — Tool to list LinkedIn industry codes from Piloterr API. Use when you need to find LinkedIn industry identifiers for targeting or classification.
  - body: { query: string }
- `POST https://api.mcp.ai/api/piloterr/search` — Tool to perform Google web search via Piloterr API. Use when you need to search the web for information using Google.
  - body: { gl?: string, hl?: string, tbs?: string, page?: integer, uule?: string, query: string, location?: string }
- `POST https://api.mcp.ai/api/piloterr/usage/get` — Tool to get usage information and remaining credits for your Piloterr account. Use when you need to check account usage and credit details.

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

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