# adhistory: Google Ads, reviews, jobs, PDFs

> adhistory: Google Ads, reviews, jobs, PDFs is a paid MCP server for marketing and seo. Competitor Google ads, app reviews and job listings as pay-per-result Apify tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://apify.com/adhistory
- **Repository:** https://github.com/obrandon/adhistory-mcp
- **MCP Registry name:** io.github.OBrandon/adhistory-mcp
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-14

## About

Each tool in this server is an Apify Actor billed by result, so costs track what you pull. The README lists competitor_google_ads at $1.00 per 1,000 results, app_reviews at $0.10 per 1,000 and workday_jobs, which reads open roles from any myworkdayjobs.com career site. The registry entry also mentions PDF tables and invoices and email checks.

The ads tool pulls what a company runs on Google Search, YouTube, Shopping, Maps, Play and Display from the Ads Transparency Center, with headline, description, format, first and last shown dates, days running and countries. A summary mode returns one row per domain. App reviews cover the App Store and Google Play, with rating, text, date, app version and developer reply, plus a star filter for complaints.

You need an Apify token, and APIFY_MAX_CHARGE_USD sets a per-call spending cap that defaults to 0.50.

## Features

- **Google ad history:** Lists a company's ads with run dates, days running and countries.
- **App review export:** Fetches App Store and Google Play reviews with an option to show only low ratings.
- **Workday job boards:** Reads open roles from myworkdayjobs.com career sites.
- **Per-call cost cap:** APIFY_MAX_CHARGE_USD limits spend per tool call.
- **Advertiser summary:** One summary row per domain through advertiserCheck mode.
- **Pay per result:** Prices are published per 1,000 results for each tool.

## Good for

- Study which ads a competitor has run longest
- Mine app reviews for complaints
- Watch a company's hiring through its Workday site
- Check ad activity for a domain before a pitch

## Install

### Claude Code (Terminal)

```sh
claude mcp add adhistory-mcp --env APIFY_TOKEN='<APIFY_TOKEN>' -- uvx adhistory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "adhistory-mcp": {
      "command": "uvx",
      "args": [
        "adhistory-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "adhistory-mcp": {
      "command": "uvx",
      "args": [
        "adhistory-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "adhistory-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "adhistory-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "adhistory-mcp": {
      "command": "uvx",
      "args": [
        "adhistory-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "adhistory-mcp": {
      "command": "uvx",
      "args": [
        "adhistory-mcp"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}
```

## Tools

- `competitor_google_ads`: Ads a company runs across Google surfaces from the Ads Transparency Center.
- `app_reviews`: App Store and Google Play reviews with an optional star filter.
- `workday_jobs`: Open jobs from a myworkdayjobs.com career site.

## FAQ

### What does it cost?

The README lists $1.00 per 1,000 ads and $0.10 per 1,000 app reviews, billed through your Apify account.

### What do I need to run it?

An Apify API token set as APIFY_TOKEN. A free Apify account works.

### Can I limit spending?

Yes. APIFY_MAX_CHARGE_USD caps each call and defaults to 0.50 dollars.

### How do I install it?

pip install adhistory-mcp, then run adhistory-mcp.

### Is adhistory: Google Ads, reviews, jobs, PDFs free?

No. adhistory: Google Ads, reviews, jobs, PDFs is a paid product.

### How do I add adhistory: Google Ads, reviews, jobs, PDFs to Claude Code?

Run this command in your terminal: claude mcp add adhistory-mcp --env APIFY_TOKEN='<APIFY_TOKEN>' -- uvx adhistory-mcp

### What are the best alternatives to adhistory: Google Ads, reviews, jobs, PDFs?

The closest alternatives to adhistory: Google Ads, reviews, jobs, PDFs are Google Ads Transparency Scraper, Google Ads Transparency (via Apify), Google Ads Transparency MCP: Competitor Ads, Ad Library: Google Ads Transparency & LinkedIn Ads and fairfetch: web data tools for AI agents, priced per result.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads Transparency Scraper](https://ai-powered.com/mcp/google-ads-transparency-scraper-3): Google Ads Transparency Scraper is a paid MCP server for web search and scraping.
- [Google Ads Transparency (via Apify)](https://ai-powered.com/mcp/google-ads-transparency-via-apify): Google Ads Transparency (via Apify) is a paid MCP server for marketing and seo.
- [Google Ads Transparency MCP: Competitor Ads](https://ai-powered.com/mcp/google-ads-transparency-mcp-competitor-ads): Google Ads Transparency MCP: Competitor Ads is a paid MCP server for marketing and seo.
- [Ad Library: Google Ads Transparency & LinkedIn Ads](https://ai-powered.com/mcp/ad-library-google-ads-transparency-and-linkedin-ads): Ad Library: Google Ads Transparency & LinkedIn Ads is a freemium MCP server for marketing and seo.
- [fairfetch: web data tools for AI agents, priced per result](https://ai-powered.com/mcp/fairfetch-web-data-tools-for-ai-agents-priced-per-result): fairfetch: web data tools for AI agents, priced per result is a freemium MCP server for web search and scraping.
- [Rowfeed Search & Market Data](https://ai-powered.com/mcp/rowfeed-search-and-market-data): Rowfeed Search & Market Data is a paid MCP server for marketing and seo.
- [subimpact data (Apify)](https://ai-powered.com/mcp/subimpact-data-apify): subimpact data (Apify) is a paid MCP server for web search and scraping.
- [Google Ads Transparency Scraper & Monitor](https://ai-powered.com/mcp/google-ads-transparency-scraper-and-monitor): Google Ads Transparency Scraper & Monitor is a paid MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/adhistory-google-ads-reviews-jobs-pdfs
