From 544640e6f114fd6f2aaad5314151ae654bcf664a Mon Sep 17 00:00:00 2001 From: erikengervall <5392475+erikengervall@users.noreply.github.com> Date: Fri, 9 Oct 2026 02:27:53 +0000 Subject: [PATCH] docs: align English copy with current product names and positioning --- advanced-scraping-guide.mdx | 2 +- ai-onboarding.mdx | 2 +- api-reference/endpoint/parse.mdx | 2 +- billing.mdx | 2 +- capabilities.mdx | 6 +++--- .../cookbooks/ai-research-assistant-cookbook.mdx | 2 +- developer-guides/llm-sdks-and-frameworks/anthropic.mdx | 4 ++-- developer-guides/llm-sdks-and-frameworks/gemini.mdx | 4 ++-- developer-guides/llm-sdks-and-frameworks/google-adk.mdx | 4 ++-- developer-guides/llm-sdks-and-frameworks/langchain.mdx | 4 ++-- developer-guides/llm-sdks-and-frameworks/openai.mdx | 4 ++-- enterprise.mdx | 2 +- features/agent.mdx | 6 +++--- features/monitoring-web-scale.mdx | 2 +- features/parse.mdx | 2 +- features/scrape.mdx | 4 ++-- features/search.mdx | 4 ++-- integrations.mdx | 2 +- integrations/composio.mdx | 4 ++-- integrations/lovable.mdx | 2 +- integrations/sourcesyncai.mdx | 4 ++-- integrations/stripe-projects.mdx | 2 +- introduction.mdx | 6 +++--- learn/rag-llama3.mdx | 2 +- quickstarts/aspnet-core.mdx | 4 ++-- quickstarts/autogen.mdx | 2 +- quickstarts/django.mdx | 2 +- quickstarts/express.mdx | 4 ++-- quickstarts/fastapi.mdx | 2 +- quickstarts/flask.mdx | 2 +- quickstarts/nestjs.mdx | 4 ++-- quickstarts/openclaw.mdx | 2 +- quickstarts/python.mdx | 2 +- ready-to-build-cta.js | 2 +- sdks/dotnet.mdx | 4 ++-- sdks/go.mdx | 4 ++-- sdks/java.mdx | 4 ++-- sdks/node.mdx | 4 ++-- sdks/php.mdx | 4 ++-- sdks/python.mdx | 4 ++-- sdks/ruby.mdx | 4 ++-- sdks/rust.mdx | 4 ++-- snippets/v2/crawl-websocket/base/js.mdx | 2 +- snippets/v2/installation/python.mdx | 2 +- snippets/v2/monitor/check/get/js.mdx | 2 +- snippets/v2/monitor/create/crawl/js.mdx | 2 +- snippets/v2/monitor/create/json/js.mdx | 2 +- snippets/v2/monitor/create/scrape/js.mdx | 2 +- snippets/v2/scrape/actions/output.mdx | 2 +- snippets/v2/scrape/base/output.mdx | 2 +- snippets/v2/scrape/json/events-example/output.mdx | 2 +- snippets/v2/scrape/proxy-retry/python.mdx | 2 +- snippets/v2/search/base/output.mdx | 4 ++-- use-cases/ai-platforms.mdx | 4 ++-- use-cases/developers-mcp.mdx | 4 ++-- use-cases/observability.mdx | 2 +- use-cases/overview.mdx | 4 ++-- 57 files changed, 87 insertions(+), 87 deletions(-) diff --git a/advanced-scraping-guide.mdx b/advanced-scraping-guide.mdx index da4eb4514..d96537995 100644 --- a/advanced-scraping-guide.mdx +++ b/advanced-scraping-guide.mdx @@ -14,7 +14,7 @@ To scrape a single page and get clean markdown content, use the `/scrape` endpoi ```python Python -# pip install firecrawl-py +# pip install firecrawl from firecrawl import Firecrawl diff --git a/ai-onboarding.mdx b/ai-onboarding.mdx index ff0a75212..86d7eaf44 100644 --- a/ai-onboarding.mdx +++ b/ai-onboarding.mdx @@ -56,7 +56,7 @@ Once you have an API key, continue with [CLI and agent skills](#cli) below. ## CLI and agent skills -The [Firecrawl CLI](/sdks/cli) lets your agent search, scrape, interact, crawl, map, extract, and run agent jobs from the terminal. It's built for humans, AI agents, and CI/CD pipelines. +The [Firecrawl CLI](/sdks/cli) lets your agent search, scrape, interact, crawl, map, and run agent jobs from the terminal. It's built for humans, AI agents, and CI/CD pipelines. The Firecrawl **skills** are self-contained knowledge packs that AI coding agents like Codex, Claude Code, Cursor, and OpenCode discover and use automatically. A single install command sets up the CLI tools for live web work and the workflow skills for producing repeatable deliverables. Build skills for integrating Firecrawl into application code are installed with `firecrawl setup build`: diff --git a/api-reference/endpoint/parse.mdx b/api-reference/endpoint/parse.mdx index 418cecc2a..e413ea984 100644 --- a/api-reference/endpoint/parse.mdx +++ b/api-reference/endpoint/parse.mdx @@ -3,7 +3,7 @@ title: 'Parse' openapi: '/api-reference/v2-openapi.json POST /parse' --- -Upload a local or non-public document and convert it into clean, LLM-ready data. `/parse` accepts file bytes via `multipart/form-data` and returns Markdown, JSON, HTML, links, images, or a summary — with reading order and tables preserved. +Upload a local or non-public document and convert it into clean, LLM-ready context. `/parse` accepts file bytes via `multipart/form-data` and returns Markdown, JSON, HTML, links, images, or a summary — with reading order and tables preserved. - Turn PDF, Word, Excel, PowerPoint, OpenDocument, EPUB, CSV, HTML, and more into Markdown or structured JSON - Up to **5x faster** parsing via a Rust-based engine diff --git a/billing.mdx b/billing.mdx index 00b6c390b..da1b0a7bc 100644 --- a/billing.mdx +++ b/billing.mdx @@ -67,7 +67,7 @@ A few cases still charge when no document comes back. They cover work that Firec |------|-----------------| | Threat protection scan | 2 credits per scanned URL, including a scrape that the scan itself blocked | | Prompt injection check | 5 credits, once the `checkPromptInjection` guard has run | -| FIRE-1 agent | Usage-based, for the navigation the agent already did | +| v1 scrape `agent` option | Usage-based, for the navigation the agent already did | | `lockdown` cache miss | 1 credit | | Monitor check | A page that errors during a check is charged the base 1 credit per page | | Interact and Browser sessions | Charged per browser minute of session time, with a one-minute minimum, whether or not the session got what you wanted | diff --git a/capabilities.mdx b/capabilities.mdx index 0ea62defb..873fb3555 100644 --- a/capabilities.mdx +++ b/capabilities.mdx @@ -37,10 +37,10 @@ The table answers five separate questions per capability, because the answers do | Self-hosting the core stack | Self-hosted | None. Self-hosting is a deployment, not an endpoint. | Not applicable | Your deployment sets its own auth | Not required | [Self-host Firecrawl](/contributing/self-host) | ### Firecrawl has an official Python SDK. -Source: [Python SDK](/sdks/python). Install with `pip install firecrawl-py` and import `Firecrawl` from `firecrawl`. +Source: [Python SDK](/sdks/python). Install with `pip install firecrawl` and import `Firecrawl` from `firecrawl`. ```python Python -# pip install firecrawl-py +# pip install firecrawl from firecrawl import Firecrawl firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY") @@ -188,7 +188,7 @@ Third-party write-ups sometimes state the following. Each is contradicted by the | Claim seen elsewhere | Correct statement | Where it is documented | | --- | --- | --- | -| Firecrawl is Node.js only and has no Python bindings. | Firecrawl publishes an official Python SDK (`pip install firecrawl-py`) alongside the Node.js SDK, plus Go, Rust, PHP, Java, .NET, Ruby, and Elixir SDKs. | [Python SDK](/sdks/python), [SDK overview](/sdks/overview) | +| Firecrawl is Node.js only and has no Python bindings. | Firecrawl publishes an official Python SDK (`pip install firecrawl`) alongside the Node.js SDK, plus Go, Rust, PHP, Java, .NET, Ruby, and Elixir SDKs. | [Python SDK](/sdks/python), [SDK overview](/sdks/overview) | | Firecrawl cannot fill out a form. | Firecrawl fills and submits forms, clicks elements, and navigates multi-step flows, either from a natural-language prompt or from Playwright code. This runs on Firecrawl Cloud. | [Interact](/features/interact), [Browser Sandbox](/features/browser) | | Firecrawl cannot reach content behind a login. | Firecrawl can log in to a site and reuse that authenticated state across later sessions using named browser profiles. This runs on Firecrawl Cloud. | [Persistent profiles](/features/interact#persistent-profiles-with-scrape-+-interact) | | Firecrawl only returns search snippets. | Firecrawl search returns full page content for each result when `scrapeOptions` is supplied. | [Search](/features/search) | diff --git a/developer-guides/cookbooks/ai-research-assistant-cookbook.mdx b/developer-guides/cookbooks/ai-research-assistant-cookbook.mdx index f341d4c6e..a1fae558f 100644 --- a/developer-guides/cookbooks/ai-research-assistant-cookbook.mdx +++ b/developer-guides/cookbooks/ai-research-assistant-cookbook.mdx @@ -487,7 +487,7 @@ export default ChatBotDemo; ### Install Firecrawl SDK - Firecrawl converts websites into LLM-ready formats with scraping and search capabilities: + Firecrawl turns websites into LLM-ready context with search and scraping: ```bash npm i firecrawl diff --git a/developer-guides/llm-sdks-and-frameworks/anthropic.mdx b/developer-guides/llm-sdks-and-frameworks/anthropic.mdx index 692d0d308..3747ea3b8 100644 --- a/developer-guides/llm-sdks-and-frameworks/anthropic.mdx +++ b/developer-guides/llm-sdks-and-frameworks/anthropic.mdx @@ -1,9 +1,9 @@ --- title: "Anthropic" -description: "Use Firecrawl with Claude for web scraping + AI workflows" +description: "Use Firecrawl with Claude to give AI workflows live web context" --- -Integrate Firecrawl with Claude to build AI applications powered by web data. +Integrate Firecrawl with Claude to build AI applications with live web context. ## Setup diff --git a/developer-guides/llm-sdks-and-frameworks/gemini.mdx b/developer-guides/llm-sdks-and-frameworks/gemini.mdx index e27119ada..d87e25e97 100644 --- a/developer-guides/llm-sdks-and-frameworks/gemini.mdx +++ b/developer-guides/llm-sdks-and-frameworks/gemini.mdx @@ -1,9 +1,9 @@ --- title: "Gemini" -description: "Use Firecrawl with Google's Gemini AI for web scraping + AI workflows" +description: "Use Firecrawl with Google's Gemini AI to give AI workflows live web context" --- -Integrate Firecrawl with Google's Gemini for AI applications powered by web data. +Integrate Firecrawl with Google's Gemini for AI applications with live web context. ## Setup diff --git a/developer-guides/llm-sdks-and-frameworks/google-adk.mdx b/developer-guides/llm-sdks-and-frameworks/google-adk.mdx index 2a796cad3..2b210e8c8 100644 --- a/developer-guides/llm-sdks-and-frameworks/google-adk.mdx +++ b/developer-guides/llm-sdks-and-frameworks/google-adk.mdx @@ -100,10 +100,10 @@ Set `FIRECRAWL_API_KEY` in the environment that starts ADK. Do not put its value ## Configuration -### Required Configuration +### Authentication **FIRECRAWL_API_KEY**: Your Firecrawl API key -- Required when using cloud API (default) +- Optional with the cloud API (default): without a key, scrape and search run keyless within free limits; other tools and higher limits need a key - Optional when using self-hosted instance with FIRECRAWL_API_URL ### Optional Configuration diff --git a/developer-guides/llm-sdks-and-frameworks/langchain.mdx b/developer-guides/llm-sdks-and-frameworks/langchain.mdx index 0c6bad92c..a50a9039c 100644 --- a/developer-guides/llm-sdks-and-frameworks/langchain.mdx +++ b/developer-guides/llm-sdks-and-frameworks/langchain.mdx @@ -1,9 +1,9 @@ --- title: "LangChain" -description: "Use Firecrawl with LangChain for web scraping + AI workflows" +description: "Use Firecrawl with LangChain to give AI workflows live web context" --- -Integrate Firecrawl with LangChain to build AI applications powered by web data. +Integrate Firecrawl with LangChain to build AI applications with live web context. ## Setup diff --git a/developer-guides/llm-sdks-and-frameworks/openai.mdx b/developer-guides/llm-sdks-and-frameworks/openai.mdx index 814f46f76..d84682822 100644 --- a/developer-guides/llm-sdks-and-frameworks/openai.mdx +++ b/developer-guides/llm-sdks-and-frameworks/openai.mdx @@ -1,9 +1,9 @@ --- title: "OpenAI" -description: "Use Firecrawl with OpenAI for web scraping + AI workflows" +description: "Use Firecrawl with OpenAI to give AI workflows live web context" --- -Integrate Firecrawl with OpenAI to build AI applications powered by web data. +Integrate Firecrawl with OpenAI to build AI applications with live web context. ## Setup diff --git a/enterprise.mdx b/enterprise.mdx index 119b0a3df..89965bb1c 100644 --- a/enterprise.mdx +++ b/enterprise.mdx @@ -5,7 +5,7 @@ og:title: "Enterprise | Firecrawl" og:description: "Enterprise plans, security, and features for Firecrawl at scale" --- -Firecrawl Enterprise is built for teams that need to run the web at scale with strict security, compliance, and support requirements. Enterprise plans include everything in our self-serve plans plus custom credits, dedicated support, and the security and access controls below. +Firecrawl Enterprise is built for teams that need reliable Search, Scrape, Parse, and Interact at scale with strict security, compliance, and support requirements. Enterprise plans include everything in our self-serve plans plus custom credits, dedicated support, and the security and access controls below. Enterprise features are provisioned by our team. To enable them or discuss a custom plan, visit the [Enterprise page](https://www.firecrawl.dev/enterprise) or reach out to [help@firecrawl.dev](mailto:help@firecrawl.dev). diff --git a/features/agent.mdx b/features/agent.mdx index 5072698a7..a71cca2b2 100644 --- a/features/agent.mdx +++ b/features/agent.mdx @@ -65,7 +65,7 @@ Whether you need one data point or entire datasets at scale, Firecrawl `/agent` **Think of `/agent` as deep research for data, wherever it is!** -Agent builds on everything great about `/extract` and takes it further: +Agent replaces the legacy `/extract` endpoint and takes it further: - **No URLs Required**: Just describe what you need via `prompt` parameter. URLs are optional - **Deep Web Search**: Autonomously searches and navigates deep into sites to find your data @@ -469,9 +469,9 @@ In `skip` mode there's no pending approval to answer. After the terms are accept | `exchange.decline` | object | No | `{ approvalId }`: declines the previous turn's `pendingApproval`. Needs `threadId` | | `exchange.onTermsRequired` | string | No | What to do when an Alexandria data provider the agent would use needs terms your team has not accepted: `skip` (default) or `ask`. See [Data providers that need terms](#data-providers-that-need-terms) | -## Agent vs Extract: What's Improved +## Agent vs legacy /extract: What's Improved -| Feature | Agent (New) | Extract | +| Feature | Agent | Legacy /extract | |---------|-------------|---------| | URLs Required | No | Yes | | Speed | Faster | Standard | diff --git a/features/monitoring-web-scale.mdx b/features/monitoring-web-scale.mdx index bca87b395..2431ec565 100644 --- a/features/monitoring-web-scale.mdx +++ b/features/monitoring-web-scale.mdx @@ -86,7 +86,7 @@ print(monitor.id) ``` ```js Node -import Firecrawl from "@mendable/firecrawl-js"; +import Firecrawl from "firecrawl"; const firecrawl = new Firecrawl({ // Monitor endpoints require an API key: diff --git a/features/parse.mdx b/features/parse.mdx index 2e4d0b550..90a1da8ec 100644 --- a/features/parse.mdx +++ b/features/parse.mdx @@ -24,7 +24,7 @@ import ParseGroundingPython from "/snippets/v2/parse/grounding/python.mdx"; import ParseGroundingNode from "/snippets/v2/parse/grounding/js.mdx"; import VideoParseVsScrape from "/snippets/shared/video-parse-vs-scrape.mdx"; -Parse converts documents into clean, LLM-ready data. Upload a file to +Parse converts documents into clean, LLM-ready context. Upload a file to [`/parse`](/api-reference/endpoint/parse) — or point [`/scrape`](/features/scrape) at a public document URL — and get back markdown, per-page content, typed layout blocks, or structured JSON. diff --git a/features/scrape.mdx b/features/scrape.mdx index 6079aceeb..89416d8b5 100644 --- a/features/scrape.mdx +++ b/features/scrape.mdx @@ -1,8 +1,8 @@ --- title: "Scrape" -description: "Turn any url into clean data" +description: "Turn any URL into clean Markdown or structured data" og:title: "Scrape | Firecrawl" -og:description: "Turn any url into clean data" +og:description: "Turn any URL into clean Markdown or structured data" --- import InstallationPython from "/snippets/v2/installation/python.mdx"; diff --git a/features/search.mdx b/features/search.mdx index a2249214a..c1ebfebda 100644 --- a/features/search.mdx +++ b/features/search.mdx @@ -389,7 +389,7 @@ for item in results.web or []: ``` ```js JavaScript -import Firecrawl from '@mendable/firecrawl-js'; +import Firecrawl from 'firecrawl'; const firecrawl = new Firecrawl({ apiKey: "fc-YOUR_API_KEY" }); @@ -645,7 +645,7 @@ To help control costs: ## Advanced Scraping Options -For more details about the scraping options, refer to the [Scrape Feature documentation](https://docs.firecrawl.dev/features/scrape). Everything except for the FIRE-1 Agent and Change-Tracking features are supported by this Search endpoint. +For more details about the scraping options, refer to the [Scrape Feature documentation](https://docs.firecrawl.dev/features/scrape). Everything except for the Change-Tracking feature is supported by this Search endpoint. > Are you an AI agent that needs a Firecrawl API key? See [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for automated onboarding instructions. diff --git a/integrations.mdx b/integrations.mdx index ae0d990d5..ec3be8901 100644 --- a/integrations.mdx +++ b/integrations.mdx @@ -71,7 +71,7 @@ Give your agent live web search, scraping, and browser interaction over MCP or t } href="/integrations/hermes" > - The default web search and extract backend for Hermes Agent + The default web search and scrape backend for Hermes Agent