# Scrapingant — how to use (mcp.ai)

Connect your Scrapingant account and use 9 tools for web scraping straight from your AI agent. Connect with your own API key. ScrapingAnt is a web scraping API service that enables data extraction from websites through headless Chrome browsers, rotating proxies, CAPTCHA/Cloudflare bypass, LLM-ready markdown output, and AI-powered structured data extraction.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/scrapingant/extract/content/as/markdown` — This tool extracts content from a given URL and converts it into Markdown format. It is particularly useful for preparing text for Language Learning Models (LLMs) and Retrieval-Augmented Generation (R
  - body: { url: string, method?: string, browser?: boolean, cookies?: string, js_snippet?: string, proxy_type?: string, proxy_country?: string, block_resource?: string[], wait_for_selector?: string, return_page_source?: boolean }
- `POST https://api.mcp.ai/api/scrapingant/extract/data/with/ai` — This tool allows you to extract structured data from a web page using ScrapingAnt's AI-powered extraction capabilities. You provide a URL and an AI query (prompt) describing what data you want to extr
  - body: { url: string, cookies?: string, proxy_type?: string, return_text?: boolean, proxy_country?: string, enable_javascript?: boolean, wait_for_selector?: string, extract_properties: string }
- `POST https://api.mcp.ai/api/scrapingant/get/api/credits/usage` — This tool retrieves the current API credit usage status for the authenticated ScrapingAnt account. It enables users to monitor their consumption of API credits, check their current usage against the s
- `POST https://api.mcp.ai/api/scrapingant/get/v1/usage` — [DEPRECATED - Use v2] Tool to get the current subscription status and API credits usage information. This is the legacy v1 endpoint which is no longer actively maintained.
- `POST https://api.mcp.ai/api/scrapingant/scrape/web/page` — This tool scrapes a web page using the ScrapingAnt API. It fetches the HTML content of the specified URL. Users can customize the scraping behavior by enabling a headless browser, using proxies, waiti
  - body: { url: string, browser?: boolean, cookies?: string, js_snippet?: string, proxy_type?: string, proxy_country?: string, block_resource?: string[], wait_for_selector?: string, return_page_source?: boolean }
- `POST https://api.mcp.ai/api/scrapingant/scrape/webpage/post` — Tool to perform a POST request through ScrapingAnt's proxy to scrape a webpage. Use when you need to scrape pages that require POST method, such as form submissions or APIs that only accept POST reque
  - body: { url: string, browser?: boolean, cookies?: string, post_data?: object, js_snippet?: string, proxy_type?: string, proxy_country?: string, block_resource?: string[], wait_for_selector?: string, return_page_source?: boolean }
- `POST https://api.mcp.ai/api/scrapingant/scrape/webpage/put` — Tool to perform a PUT request through ScrapingAnt's proxy to scrape a webpage that requires PUT method. Use when the target webpage requires PUT method for data submission. Data is forwarded transpare
  - body: { url: string, browser?: boolean, cookies?: string, js_snippet?: string, proxy_type?: string, content_type?: string, request_body?: string, proxy_country?: string, block_resource?: string[], wait_for_selector?: string, return_page_source?: boolean }
- `POST https://api.mcp.ai/api/scrapingant/scrape/webpage/v1/post` — [DEPRECATED - Use v2] Tool to scrape a webpage using POST method with ScrapingAnt's v1 API. Returns JSON with content, cookies, and status_code. This is the legacy v1 endpoint which is no longer activ
  - body: { url: string, browser?: boolean, cookies?: string, js_snippet?: string, proxy_type?: string, return_text?: boolean, proxy_country?: string, wait_for_selector?: string }
- `POST https://api.mcp.ai/api/scrapingant/scrape/with/extended/json/output` — Scrapes a web page and returns comprehensive data including HTML content, plain text, cookies, HTTP headers, XHR/Fetch requests, and iframe content. This tool uses ScrapingAnt's extended endpoint whic
  - body: { url: string, browser?: boolean, cookies?: string, timeout?: integer, proxy_type?: string, proxy_country?: string, wait_for_selector?: string, return_page_source?: boolean }

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

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