# fairfetch MCP server

> Provides AI agents with structured web data from Google Trends, Ads, App Stores, job boards, and more via Apify Actors.

- Repository: https://github.com/fairfetch-data/fairfetch-mcp
- Page: https://hostedmcp.org/servers/fairfetch-data/fairfetch-mcp
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http fairfetch-mcp 'https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper'
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "fairfetch-mcp": {
      "url": "https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "fairfetch-mcp": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"fairfetch-mcp","type":"http","url":"https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper"}'
```

### Codex

```sh
codex mcp add fairfetch-mcp --url 'https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper'
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.fairfetch-mcp]
url = "https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http fairfetch-mcp 'https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper'
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "fairfetch-mcp": {
      "url": "https://mcp.apify.com/?tools=fairfetch/google-trends-scraper,fairfetch/keyword-search-volume,fairfetch/google-ads-transparency-scraper,fairfetch/app-store-google-play-scraper,fairfetch/career-site-jobs-api,fairfetch/remote-jobs-scraper,fairfetch/document-to-markdown,fairfetch/website-screenshot-api,fairfetch/au-supermarket-prices,fairfetch/eventbrite-events-scraper",
      "type": "http"
    }
  }
}
```

## Tools (14)

- `get-actor-run`: Get detailed information about a specific Actor run. Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep. - summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available."). - nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=..."). - waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning. USAGE: - Use to check the status of a run started by any Actor-running tool. - Pass waitSecs > 0 to block until terminal (or until the cap elapses). USAGE EXAMPLES: - user_input: Show details of run y2h7sK3Wc - user_input: Wait for run y2h7sK3Wc to finish (read-only)
- `get-dataset-items`: Get items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields. USAGE: - Use when you need to read data from a dataset (all items or only selected fields). USAGE EXAMPLES: - user_input: Retrieve results from dataset abc123 - user_input: Get only metadata.url and title from dataset username~my-dataset (read-only)
- `get-key-value-store-record`: Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically. A record over 262144 bytes is returned as a link to download it, not as its value. USAGE: - Use when you need to retrieve a specific record (JSON, text, or binary) from a store. USAGE EXAMPLES: - user_input: Get record INPUT from store abc123 - user_input: Get record data.json from store username~my-store (read-only)
- `abort-actor-run`: Abort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request. USAGE: - Use when you need to stop a run that is taking too long or misconfigured. USAGE EXAMPLES: - user_input: Abort run y2h7sK3Wc - user_input: Gracefully abort run y2h7sK3Wc
- `fairfetch--google-trends-scraper`: This tool calls the Actor "fairfetch/google-trends-scraper" and retrieves its output results. Actor description: Google Trends data for many search terms per run: interest over time, interest by country, region or city, top and rising related queries, comparisons of up to 5 terms on one scale, and Trending Now searches. Throttled requests are retried on new IPs. $0.30 per 1,000 rows.
- `fairfetch--keyword-search-volume`: This tool calls the Actor "fairfetch/keyword-search-volume" and retrieves its output results. Actor description: Google Ads keyword data in bulk: monthly search volume, CPC, competition, top-of-page bids and 12-month trend for up to 20,000 keywords, any country and language, plus optional keyword ideas. $6 per 1,000 keywords + $0.10 per fresh lookup (up to 1,000 keywords each).
- `fairfetch--google-ads-transparency-scraper`: This tool calls the Actor "fairfetch/google-ads-transparency-scraper" and retrieves its output results. Actor description: Scrape every ad an advertiser runs on Google from the Ads Transparency Center: search by brand name, advertiser ID or domain, filter by country, date, format and platform. Get ad images, YouTube links, first/last shown dates, regions, EU reach and ad text where Google shows it. $2 per 1,000 ads.
- `fairfetch--app-store-google-play-scraper`: This tool calls the Actor "fairfetch/app-store-google-play-scraper" and retrieves its output results. Actor description: Apple App Store and Google Play in one Actor and one schema: app details, ratings, installs, reviews, search and top charts by country and category. No reviewer names or IDs; emails, phones and @handles in reviews and developer replies redacted. $1.50 per 1,000 apps, $0.10 per 1,000 reviews.
- `fairfetch--career-site-jobs-api`: This tool calls the Actor "fairfetch/career-site-jobs-api" and retrieves its output results. Actor description: Get every open job from company career sites on Greenhouse, Lever, Ashby, Workday and SmartRecruiters via their public job-board feeds. Normalized fields, salary ranges, clean descriptions, filters, and new/closed job tracking between runs. $1.50 per 1,000 jobs.
- `fairfetch--remote-jobs-scraper`: This tool calls the Actor "fairfetch/remote-jobs-scraper" and retrieves its output results. Actor description: Remote jobs from Remote OK and Jobicy in one clean schema: salaries, where applicants may live, seniority, cross-board de-duplication and new/closed job tracking between runs. Board attribution built in, no personal-data fields. $1 per 1,000 jobs.
- `fairfetch--document-to-markdown`: This tool calls the Actor "fairfetch/document-to-markdown" and retrieves its output results. Actor description: Convert PDFs, Word, PowerPoint, Excel, CSV, text files and web pages from URLs into clean Markdown and plain text for LLMs, RAG and AI agents. Headings, lists, tables, metadata, page splits, scanned-PDF detection. $2 per 1,000 documents + $0.10 per 1,000 PDF pages.
- `fairfetch--website-screenshot-api`: This tool calls the Actor "fairfetch/website-screenshot-api" and retrieves its output results. Actor description: Capture PNG, JPEG or PDF screenshots of any public web page with headless Chrome. Full-page, custom viewport, mobile device emulation, dark mode, cookie-banner hiding. Public link per screenshot. Pay only for real captures: $3 per 1,000 screenshots, $10 per 1,000 full-page or PDF, $0.005 per run.
- `fairfetch--au-supermarket-prices`: This tool calls the Actor "fairfetch/au-supermarket-prices" and retrieves its output results. Actor description: Coles, Woolworths and ALDI Australia prices in one format: price, was price, half-price and multibuy specials, unit price per kg / L / each, category, barcode, stock. Search, category, specials or product IDs. Tracks price and special changes. $1.50 per 1,000 products.
- `fairfetch--eventbrite-events-scraper`: This tool calls the Actor "fairfetch/eventbrite-events-scraper" and retrieves its output results. Actor description: Search Eventbrite events by city or online, keyword, category, event type, date range and free/paid, or read event URLs. One clean row per event: start/end with time zone, venue with coordinates, organizer, ticket price range, sales status, optional full description. $2.50 per 1,000 events.

## FAQ

### How much does it cost to use fairfetch?

You pay per result returned plus a small start fee per run, with no subscription or platform usage fee.

### How can I control spending when using these tools with an agent?

You can set usage limits in your Apify account or use a prepaid agent token to ensure the agent cannot spend more than its balance.
