# SmartFetch — B2B Lead & Tech Intel, Site Map, Web Reader & MCP (`smartfetch.dev/smartfetch`) Actor

Bulk B2B Lead & Tech-Stack Enrichment (bulk_inspect: up to 50 domains -> CSV/Excel-ready emails, socials, tech stack, HSTS/CSP), Website URL Mapping (map via sitemaps & links), Headless Chromium Screenshots (screenshot), PDF/Markdown Retrieval (fetch/batch_fetch) & Standby MCP Server (/mcp).

- **URL**: https://apify.com/smartfetch.dev/smartfetch.md
- **Developed by:** [SmartFetch](https://apify.com/smartfetch.dev) (community)
- **Features:** Limited permissions, Multi-tenant, Server interface
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 page fetcheds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SmartFetch — Google Maps B2B Leads, Site Intel, Stealth Web Reader & Standby MCP

SmartFetch is an all-in-one **B2B Lead Enrichment**, **Site Intelligence**, **Stealth Web/PDF-to-Markdown**, **Screenshot**, and **Standby MCP Server** Actor built for AI agents, growth teams, and automated workflows.

### Key Capabilities

#### 1. Google Maps B2B Lead, Email & Tech-Stack Scraper (`search_leads`)

Search **Google Maps Places** or **Web** for any business niche and location (e.g., `"dentists in Austin TX"`) and automatically enrich every company website in parallel:

- **Verified Contacts**: Emails, phone numbers (merged from Google Maps + website), `/contact`, `/about`, and `/pricing` links
- **Google Maps Pin Data**: Business name, category, star rating, review count, street address, and Maps phone
- **Social Links**: LinkedIn, GitHub, X/Twitter
- **Email & Domain Intel**: DNS `MX` (Google Workspace / Microsoft 365), `SPF`, `DMARC`, and RDAP domain age
- **30+ Tech Stack Signatures**: Next.js, React, Shopify, WordPress, Webflow, Stripe, HubSpot, Cloudflare, and more
- **Ready-to-Use Exports**: Clean Dataset rows + **`LEADS.csv`** in Key-Value Store

#### 2. Bulk B2B Domain & Tech-Stack Enrichment (`bulk_inspect`)

Supply up to **50 bare domains or URLs** (e.g., `["stripe.com", "linear.app"]`) and enrich them concurrently into flat, CSV/Excel-ready rows with contacts, social links, security headers (`HTTPS`, `HSTS`, `CSP`), DNS mail records, RDAP age, and tech stack.

#### 3. Stealth Web Scraper, PDF-to-Markdown, Screenshots & URL Mapper

- **`fetch`**: Chrome TLS-impersonated HTTP -> PDF extraction -> headless Chromium fallback returning LLM-clean Markdown and plain text
- **`screenshot`**: High-resolution desktop (`1280x800`) or mobile (`390x844`) JPEG/PNG screenshots with optional full-page capture
- **`map`**: Fast `robots.txt`, XML sitemap (`<sitemapindex>`), and internal link discovery (up to 500 URLs)
- **`batch_fetch`**: Parallel retrieval of up to 5 URLs

#### 4. Standby MCP Server (`/mcp`)

Connect any MCP client (Claude Desktop, Cursor, custom agents) to `https://smartfetch-dev--smartfetch.apify.actor/mcp` with `Authorization: Bearer <APIFY_API_TOKEN>`.

### Pay-Per-Event (PPE) Pricing

- `actor-start`: `$0.00` (no startup fee)
- `page-fetched`: **`$0.01`** per webpage, PDF, or site map (`fetch`, `batch_fetch`, `map`)
- `site-inspected`: **`$0.01`** per enriched lead or site inspection (`search_leads`, `inspect`, `bulk_inspect`)
- `screenshot-captured`: **`$0.02`** per headless Chromium screenshot (`screenshot`)
- **Zero charge on errors or unconfigured requests.**

# Actor input Schema

## `action` (type: `string`):

Operation to perform: fetch (Markdown/text extraction), screenshot (headless Chromium image), inspect (structured SEO & site intelligence), batch_fetch (parallel multi-URL retrieval), bulk_inspect (B2B Lead & Tech-Stack Enrichment across up to 50 domains), or map (discover internal URLs from sitemaps & links).

## `url` (type: `string`):

Public HTTP/HTTPS webpage or PDF URL (used for fetch, screenshot, inspect, and map).

## `urls` (type: `array`):

List of public URLs or bare domains (e.g. stripe.com) for batch_fetch (up to 5 URLs) or bulk_inspect (up to 50 domains for paying users, 5 on the Free plan).

## `search` (type: `string`):

Optional case-insensitive substring filter when action is 'map' (e.g. 'docs' or 'pricing').

## `include_subdomains` (type: `boolean`):

Include URLs on subdomains of the target domain when action is 'map'.

## `max_urls` (type: `integer`):

Maximum number of URLs to return when action is 'map' (1-500).

## `query` (type: `string`):

Business or niche search query when action is 'search_leads' (e.g. 'dental clinics austin tx').

## `lead_source` (type: `string`):

Lead discovery source when action is 'search_leads': 'maps' (Google Places) or 'web'.

## `max_leads` (type: `integer`):

Maximum number of leads to enrich when action is 'search_leads' (up to 25 paying, 5 free).

## `max_chars` (type: `integer`):

Maximum character length returned for extracted Markdown and plain text.

## `render_mode` (type: `string`):

Rendering strategy: 'auto' (fast HTTP with automatic headless Chromium escalation on SPA shells), 'http_only', or 'browser'.

## `viewport` (type: `string`):

Viewport preset for screenshots: 'desktop' (1280x800) or 'mobile' (390x844).

## `full_page` (type: `boolean`):

Capture the full scrollable page height (up to 4000px).

## `image_format` (type: `string`):

Output image format for screenshots ('jpeg' or 'png').

## `no_cache` (type: `boolean`):

Bypass in-memory response caching.

## Actor input object example

```json
{
  "action": "fetch",
  "url": "https://example.com",
  "urls": [],
  "search": "",
  "include_subdomains": false,
  "max_urls": 200,
  "query": "",
  "lead_source": "maps",
  "max_leads": 5,
  "max_chars": 20000,
  "render_mode": "auto",
  "viewport": "desktop",
  "full_page": false,
  "image_format": "jpeg",
  "no_cache": false
}
```

# Actor output Schema

## `results` (type: `string`):

Extracted Markdown, plain text, site inspection metadata, or batch retrieval records.

## `screenshots` (type: `string`):

Captured screenshot image files (screenshot.jpg / screenshot.png) stored in the default Key-Value Store.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("smartfetch.dev/smartfetch").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("smartfetch.dev/smartfetch").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call smartfetch.dev/smartfetch --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,smartfetch.dev/smartfetch"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yoScWS9LH7NQnXahw/builds/PekfpzFBQEwj15dpS/openapi.json
