---
name: "xpay-firecrawl-firecrawl-map"
description: "
Map a website to discover all indexed URLs on the site.

**Best for:** Discovering URLs on a website before deciding what to scrape; finding specific sections or pages within a large site; locating the correct page when scrape returns empty or incomplete results.
**Not recommended for:** When you already know which specific URL you need (use scrape); when you need the content of the pages (use scrape after mapping).
**Common mistakes:** Using crawl to discover URLs instead of map; jumping straight to firecrawl_agent when scrape fails instead of using map first to find the right page.

**IMPORTANT - Use map before agent:** If `firecrawl_scrape` returns empty, minimal, or irrelevant content, use `firecrawl_map` with the `search` parameter to find the specific page URL containing your target content. This is faster and cheaper than using `firecrawl_agent`. Only use the agent as a last resort after map+scrape fails.

**Prompt Example:** \"Find the webhook documentation page on this API docs site.\"
**Usage Example (discover all URLs):**
```json
{
  \"name\": \"firecrawl_map\",
  \"arguments\": {
    \"url\": \"https://example.com\"
  }
}
```
**Usage Example (search for specific content - RECOMMENDED when scrape fails):**
```json
{
  \"name\": \"firecrawl_map\",
  \"arguments\": {
    \"url\": \"https://docs.example.com/api\",
    \"search\": \"webhook events\"
  }
}
```
**Returns:** Array of URLs found on the site, filtered by search query if provided.
"
version: "1.0.0"
price: "$0.02/call"
provider: "Firecrawl"
---

# Firecrawl Map


Map a website to discover all indexed URLs on the site.

**Best for:** Discovering URLs on a website before deciding what to scrape; finding specific sections or pages within a large site; locating the correct page when scrape returns empty or incomplete results.
**Not recommended for:** When you already know which specific URL you need (use scrape); when you need the content of the pages (use scrape after mapping).
**Common mistakes:** Using crawl to discover URLs instead of map; jumping straight to firecrawl_agent when scrape fails instead of using map first to find the right page.

**IMPORTANT - Use map before agent:** If `firecrawl_scrape` returns empty, minimal, or irrelevant content, use `firecrawl_map` with the `search` parameter to find the specific page URL containing your target content. This is faster and cheaper than using `firecrawl_agent`. Only use the agent as a last resort after map+scrape fails.

**Prompt Example:** "Find the webhook documentation page on this API docs site."
**Usage Example (discover all URLs):**
```json
{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com"
  }
}
```
**Usage Example (search for specific content - RECOMMENDED when scrape fails):**
```json
{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://docs.example.com/api",
    "search": "webhook events"
  }
}
```
**Returns:** Array of URLs found on the site, filtered by search query if provided.


**Provider:** Firecrawl
**Price:** $0.02/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to 
map a website to discover all indexed urls on the site.

**best for:** discovering urls on a website before deciding what to scrape; finding specific sections or pages within a large site; locating the correct page when scrape returns empty or incomplete results.
**not recommended for:** when you already know which specific url you need (use scrape); when you need the content of the pages (use scrape after mapping).
**common mistakes:** using crawl to discover urls instead of map; jumping straight to firecrawl_agent when scrape fails instead of using map first to find the right page.

**important - use map before agent:** if `firecrawl_scrape` returns empty, minimal, or irrelevant content, use `firecrawl_map` with the `search` parameter to find the specific page url containing your target content. this is faster and cheaper than using `firecrawl_agent`. only use the agent as a last resort after map+scrape fails.

**prompt example:** "find the webhook documentation page on this api docs site."
**usage example (discover all urls):**
```json
{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com"
  }
}
```
**usage example (search for specific content - recommended when scrape fails):**
```json
{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://docs.example.com/api",
    "search": "webhook events"
  }
}
```
**returns:** array of urls found on the site, filtered by search query if provided.
. This is part of the Firecrawl provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 12+ others):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("firecrawl/firecrawl_map")`
2. **`xpay_run`** — Execute: `xpay_run("firecrawl/firecrawl_map", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | number | No |  |
| `search` | string | No |  |
| `includeSubdomains` | boolean | No |  |
| `ignoreQueryParameters` | boolean | No |  |
| `url` | string | Yes |  |
| `sitemap` | string | No |  |

## Pricing

- **Cost:** $0.02/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Firecrawl (all tools)](https://xpay.tools/skills/firecrawl/SKILL.md) — 13 tools
- [Firecrawl Scrape](https://xpay.tools/skills/firecrawl/firecrawl-scrape/SKILL.md) — $0.03/call
- [Firecrawl Search](https://xpay.tools/skills/firecrawl/firecrawl-search/SKILL.md) — $0.03/call
- [Firecrawl Crawl](https://xpay.tools/skills/firecrawl/firecrawl-crawl/SKILL.md) — $0.05/call
- [Firecrawl Check Crawl Status](https://xpay.tools/skills/firecrawl/firecrawl-check-crawl-status/SKILL.md) — $0.03/call
- [Firecrawl Extract](https://xpay.tools/skills/firecrawl/firecrawl-extract/SKILL.md) — $0.05/call

## Links

- Tool page: https://xpay.tools/firecrawl/firecrawl-map/
- Provider: https://xpay.tools/firecrawl/
- All tools: https://xpay.tools/explore