{
"canonical_name": "firecrawl/firecrawl",
"compilation_id": "pack_83287753ee364d18ae6639cac0ace700",
"created_at": "2026-05-19T08:36:46.050081+00:00",
"created_by": "project-pack-compiler",
"feedback": {
"carrier_selection_notes": [
"viable_asset_types=skill, recipe, host_instruction, eval, preflight",
"recommended_asset_types=skill, recipe, host_instruction, eval, preflight"
],
"evidence_delta": {
"confirmed_claims": [
"identity_anchor_present",
"capability_and_host_targets_present",
"install_path_declared_or_better"
],
"missing_required_fields": [],
"must_verify_forwarded": [
"Run or inspect `npx -y firecrawl-cli@latest` in an isolated environment.",
"Confirm the project exposes the claimed capability to at least one target host."
],
"quickstart_execution_scope": "allowlisted_sandbox_smoke",
"sandbox_command": "npx -y firecrawl-cli@latest",
"sandbox_container_image": "node:22-slim",
"sandbox_execution_backend": "docker",
"sandbox_planner_decision": "deterministic_isolated_install",
"sandbox_validation_id": "sbx_a04a9373bfe94aa0a136566a0c913d0d"
},
"feedback_event_type": "project_pack_compilation_feedback",
"learning_candidate_reasons": [],
"template_gaps": []
},
"identity": {
"canonical_id": "project_337392ca802daaed83bd5afc727f735b",
"canonical_name": "firecrawl/firecrawl",
"homepage_url": null,
"license": "unknown",
"repo_url": "https://github.com/firecrawl/firecrawl",
"slug": "firecrawl",
"source_packet_id": "phit_960bb077ed8b44929449275d3a2c7f98",
"source_validation_id": "dval_9158bef2a4034d23ab2b340668b353d5"
},
"merchandising": {
"best_for": "需要内容营销与增长能力，并使用 local_cli的用户",
"github_forks": 7331,
"github_stars": 117823,
"one_liner_en": "🔥 The API to search, scrape, and interact with the web for AI",
"one_liner_zh": "🔥 The API to search, scrape, and interact with the web for AI",
"primary_category": {
"category_id": "content-growth",
"confidence": "high",
"name_en": "Content & Growth",
"name_zh": "内容营销与增长",
"reason": "curated popular coverage category matched project identity"
},
"target_user": "使用 local_cli 等宿主 AI 的用户",
"title_en": "firecrawl",
"title_zh": "firecrawl 能力包",
"visible_tags": [
{
"label_en": "Browser Agents",
"label_zh": "浏览器 Agent",
"source": "repo_evidence_project_characteristics",
"tag_id": "product_domain-browser-agents",
"type": "product_domain"
},
{
"label_en": "Web Task Automation",
"label_zh": "网页任务自动化",
"source": "repo_evidence_project_characteristics",
"tag_id": "user_job-web-task-automation",
"type": "user_job"
},
{
"label_en": "Natural-language Web Actions",
"label_zh": "自然语言网页操作",
"source": "repo_evidence_project_characteristics",
"tag_id": "core_capability-natural-language-web-actions",
"type": "core_capability"
},
{
"label_en": "Multi-role Workflow",
"label_zh": "多角色协作流程",
"source": "repo_evidence_project_characteristics",
"tag_id": "workflow_pattern-multi-role-workflow",
"type": "workflow_pattern"
},
{
"label_en": "Structured Data Extraction",
"label_zh": "结构化数据提取",
"source": "repo_evidence_project_characteristics",
"tag_id": "selection_signal-structured-data-extraction",
"type": "selection_signal"
}
]
},
"packet_id": "phit_960bb077ed8b44929449275d3a2c7f98",
"page_model": {
"artifacts": {
"artifact_slug": "firecrawl",
"files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json",
"REPO_INSPECTION.md",
"CAPABILITY_CONTRACT.json",
"EVIDENCE_INDEX.json",
"CLAIM_GRAPH.json"
],
"required_files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json"
]
},
"detail": {
"capability_source": "Project Hit Packet + DownstreamValidationResult",
"commands": [
{
"command": "npx -y firecrawl-cli@latest",
"label": "Node.js / npx · 官方安装入口",
"source": "https://github.com/firecrawl/firecrawl#readme",
"verified": true
}
],
"display_tags": [
"浏览器 Agent",
"网页任务自动化",
"自然语言网页操作",
"多角色协作流程",
"结构化数据提取"
],
"eyebrow": "内容营销与增长",
"glance": [
{
"body": "判断自己是不是目标用户。",
"label": "最适合谁",
"value": "需要内容营销与增长能力，并使用 local_cli的用户"
},
{
"body": "先理解能力边界，再决定是否继续。",
"label": "核心价值",
"value": "🔥 The API to search, scrape, and interact with the web for AI"
},
{
"body": "未完成验证前保持审慎。",
"label": "继续前",
"value": "publish to Doramagic.ai project surfaces"
}
],
"guardrail_source": "Boundary & Risk Card",
"guardrails": [
{
"body": "Prompt Preview 只展示流程，不证明项目已安装或运行。",
"label": "Check 1",
"value": "不要把试用当真实运行"
},
{
"body": "local_cli",
"label": "Check 2",
"value": "确认宿主兼容"
},
{
"body": "publish to Doramagic.ai project surfaces",
"label": "Check 3",
"value": "先隔离验证"
}
],
"mode": "skill, recipe, host_instruction, eval, preflight",
"pitfall_log": {
"items": [
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：RFC: Lightweight External Memory Capsule Pattern for Firecrawl Agent Workflows",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_0bf31b0e8c3b45fb8da04cebb259c8a4 | https://github.com/firecrawl/firecrawl/issues/3500 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "high",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：RFC: Lightweight External Memory Capsule Pattern for Firecrawl Agent Workflows",
"user_impact": "可能影响升级、迁移或版本选择。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v2.4.0",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_e1e417d6cea44fb79118e4daeac083a0 | https://github.com/firecrawl/firecrawl/releases/tag/v2.4.0 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.4.0",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个配置相关的待验证问题：[Bug] /interact with language=\"python\" flakily fails with TargetClosedError on scrape-bound sessions",
"category": "配置坑",
"evidence": [
"community_evidence:github | cevd_aa487261676d400197da5f3646baff2f | https://github.com/firecrawl/firecrawl/issues/3498 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：[Bug] /interact with language=\"python\" flakily fails with TargetClosedError on scrape-bound sessions",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "README/documentation is current enough for a first validation pass.",
"category": "能力坑",
"evidence": [
"capability.assumptions | github_repo:787076358 | https://github.com/firecrawl/firecrawl | README/documentation is current enough for a first validation pass."
],
"severity": "medium",
"suggested_check": "将假设转成下游验证清单。",
"title": "能力判断依赖假设",
"user_impact": "假设不成立时，用户拿不到承诺的能力。"
},
{
"body": "GitHub 社区证据显示该项目存在一个运行相关的待验证问题：[Feat] Emit batch scrape failures of each page to webhook",
"category": "运行坑",
"evidence": [
"community_evidence:github | cevd_80c638d597cc432b9a74e7e336b043ee | https://github.com/firecrawl/firecrawl/issues/2576 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：[Feat] Emit batch scrape failures of each page to webhook",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "未记录 last_activity_observed。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:787076358 | https://github.com/firecrawl/firecrawl | last_activity_observed missing"
],
"severity": "medium",
"suggested_check": "补 GitHub 最近 commit、release、issue/PR 响应信号。",
"title": "维护活跃度未知",
"user_impact": "新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"downstream_validation.risk_items | github_repo:787076358 | https://github.com/firecrawl/firecrawl | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "进入安全/权限治理复核队列。",
"title": "下游验证发现风险项",
"user_impact": "下游已经要求复核，不能在页面中弱化。"
},
{
"body": "No sandbox install has been executed yet; downstream must verify before user use.",
"category": "安全/权限坑",
"evidence": [
"risks.safety_notes | github_repo:787076358 | https://github.com/firecrawl/firecrawl | No sandbox install has been executed yet; downstream must verify before user use."
],
"severity": "medium",
"suggested_check": "转成明确权限清单和安全审查提示。",
"title": "存在安全注意事项",
"user_impact": "用户安装前需要知道权限边界和敏感操作。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"risks.scoring_risks | github_repo:787076358 | https://github.com/firecrawl/firecrawl | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "把风险写入边界卡，并确认是否需要人工复核。",
"title": "存在评分风险",
"user_impact": "风险会影响是否适合普通用户安装。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：[Feat] Support custom HTTP headers in Node.js SDK for self-hosted instances behind reverse proxies",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_ef6deffa53c147b29e617225612e55b0 | https://github.com/firecrawl/firecrawl/issues/2814 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：[Feat] Support custom HTTP headers in Node.js SDK for self-hosted instances behind reverse proxies",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.0.1",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_0334c6a4c3284763a02c66ac96ce9c0c | https://github.com/firecrawl/firecrawl/releases/tag/v2.0.1 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.0.1",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.1.0",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_360eac170b12452583bb9b7072acc4e3 | https://github.com/firecrawl/firecrawl/releases/tag/v2.1.0 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.1.0",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.2.0",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_749e0e1b86ba455585d343764588f00e | https://github.com/firecrawl/firecrawl/releases/tag/v2.2.0 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.2.0",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.3.0",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_e6f1735e34a34eacb7b77e7bb21644a6 | https://github.com/firecrawl/firecrawl/releases/tag/v2.3.0 | 来源讨论提到 npm 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.3.0",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.5.0 - The World's Best Web Data API",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_4f928a2f370b4186ba4031bc4830020c | https://github.com/firecrawl/firecrawl/releases/tag/v2.5.0 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.5.0 - The World's Best Web Data API",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v2.6.0",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_38343ea51e374e86a5081e46c837468c | https://github.com/firecrawl/firecrawl/releases/tag/v2.6.0 | 来源讨论提到 python 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v2.6.0",
"user_impact": "可能影响授权、密钥配置或安全边界。"
}
],
"source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals",
"summary": "发现 21 个潜在踩坑项，其中 1 个为 high/blocking；最高优先级：安全/权限坑 - 来源证据：RFC: Lightweight External Memory Capsule Pattern for Firecrawl Agent Workflows。",
"title": "踩坑日志"
},
"snapshot": {
"contributors": 151,
"forks": 7331,
"license": "unknown",
"note": "站点快照，非实时质量证明；用于开工前背景判断。",
"stars": 117823
},
"source_url": "https://github.com/firecrawl/firecrawl",
"steps": [
{
"body": "不安装项目，先体验能力节奏。",
"code": "preview",
"title": "先试 Prompt"
},
{
"body": "理解输入、输出、失败模式和边界。",
"code": "manual",
"title": "读说明书"
},
{
"body": "把上下文交给宿主 AI 继续工作。",
"code": "context",
"title": "带给 AI"
},
{
"body": "进入主力环境前先完成安装入口与风险边界验证。",
"code": "verify",
"title": "沙箱验证"
}
],
"subtitle": "🔥 The API to search, scrape, and interact with the web for AI",
"title": "firecrawl 能力包",
"trial_prompt": "# firecrawl - Prompt Preview\n\n> Copy the prompt below into your AI host before installing anything.\n> Its purpose is to let you safely feel the project's workflow, not to claim the project has already run.\n\n## Copy this prompt\n\n```text\nYou are using an independent Doramagic capability pack for firecrawl/firecrawl.\n\nProject:\n- Name: firecrawl\n- Repository: https://github.com/firecrawl/firecrawl\n- Summary: 🔥 The API to search, scrape, and interact with the web for AI\n- Host target: local_cli\n\nGoal:\nHelp me evaluate this project for the following task without installing it yet: 🔥 The API to search, scrape, and interact with the web for AI\n\nBefore taking action:\n1. Restate my task, success standard, and boundary.\n2. Identify whether the next step requires tools, browser access, network access, filesystem access, credentials, package installation, or host configuration.\n3. Use only the Doramagic Project Pack, the upstream repository, and the source-linked evidence listed below.\n4. If a real command, install step, API call, file write, or host integration is required, mark it as \"requires post-install verification\" and ask for approval first.\n5. If evidence is missing, say \"evidence is missing\" instead of filling the gap.\n\nPreviewable capabilities:\n- Capability 1: 🔥 The API to search, scrape, and interact with the web for AI\n\nCapabilities that require post-install verification:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCore service flow:\n1. introduction: Introduction to Firecrawl. Produce one small intermediate artifact and wait for confirmation.\n2. system-architecture: System Architecture. Produce one small intermediate artifact and wait for confirmation.\n3. search-functionality: Search Functionality. Produce one small intermediate artifact and wait for confirmation.\n4. scraper-engine: Web Scraper Engine. Produce one small intermediate artifact and wait for confirmation.\n5. agent-capabilities: Agent and Deep Research. Produce one small intermediate artifact and wait for confirmation.\n\nSource-backed evidence to keep in mind:\n- https://github.com/firecrawl/firecrawl\n- https://github.com/firecrawl/firecrawl#readme\n- README.md\n- apps/api/src/index.ts\n- apps/api/src/routes/v2.ts\n- apps/api/src/services/index.ts\n- apps/api/src/lib/crawl-redis.ts\n- apps/api/src/search/index.ts\n- apps/api/src/search/v2/fireEngine-v2.ts\n- apps/api/src/search/v2/searxng.ts\n\nFirst response rules:\n1. Start Step 1 only.\n2. Explain the one service action you will perform first.\n3. Ask exactly three questions about my target workflow, success standard, and sandbox boundary.\n4. Stop and wait for my answers.\n\nStep 1 follow-up protocol:\n- After I answer the first three questions, stay in Step 1.\n- Produce six parts only: clarified task, success standard, boundary conditions, two or three options, tradeoffs for each option, and one recommendation.\n- End by asking whether I confirm the recommendation.\n- Do not move to Step 2 until I explicitly confirm.\n\nConversation rules:\n- Advance one step at a time and wait for confirmation after each small artifact.\n- Write outputs as recommendations or planned checks, not as completed execution.\n- Do not claim tests passed, files changed, commands ran, APIs were called, or the project was installed.\n- If the user asks for execution, first provide the sandbox setup, expected output, rollback, and approval checkpoint.\n```\n",
"voices": [
{
"body": "来源平台：github。github/github_issue: [Feat] Support custom HTTP headers in Node.js SDK for self-hosted instan（https://github.com/firecrawl/firecrawl/issues/2814）；github/github_issue: [Feat] Emit batch scrape failures of each page to webhook（https://github.com/firecrawl/firecrawl/issues/2576）；github/github_issue: RFC: Lightweight External Memory Capsule Pattern for Firecrawl Agent Wor（https://github.com/firecrawl/firecrawl/issues/3500）；github/github_issue: [Bug] /interact with language=\"python\" flakily fails with TargetClosedEr（https://github.com/firecrawl/firecrawl/issues/3498）；github/github_release: v2.9.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.9.0）；github/github_release: v2.8.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.8.0）；github/github_release: v2.7.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.7.0）；github/github_release: v2.6.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.6.0）；github/github_release: v2.5.0 - The World's Best Web Data API（https://github.com/firecrawl/firecrawl/releases/tag/v2.5.0）；github/github_release: v2.4.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.4.0）；github/github_release: v2.3.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.3.0）；github/github_release: v2.2.0（https://github.com/firecrawl/firecrawl/releases/tag/v2.2.0）。这些是项目级外部声音，不作为单独质量证明。",
"items": [
{
"kind": "github_issue",
"source": "github",
"title": "[Feat] Support custom HTTP headers in Node.js SDK for self-hosted instan",
"url": "https://github.com/firecrawl/firecrawl/issues/2814"
},
{
"kind": "github_issue",
"source": "github",
"title": "[Feat] Emit batch scrape failures of each page to webhook",
"url": "https://github.com/firecrawl/firecrawl/issues/2576"
},
{
"kind": "github_issue",
"source": "github",
"title": "RFC: Lightweight External Memory Capsule Pattern for Firecrawl Agent Wor",
"url": "https://github.com/firecrawl/firecrawl/issues/3500"
},
{
"kind": "github_issue",
"source": "github",
"title": "[Bug] /interact with language=\"python\" flakily fails with TargetClosedEr",
"url": "https://github.com/firecrawl/firecrawl/issues/3498"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.9.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.9.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.8.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.8.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.7.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.7.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.6.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.6.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.5.0 - The World's Best Web Data API",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.5.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.4.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.4.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.3.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.3.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v2.2.0",
"url": "https://github.com/firecrawl/firecrawl/releases/tag/v2.2.0"
}
],
"status": "已收录 12 条来源",
"title": "社区讨论"
}
]
},
"homepage_card": {
"category": "内容营销与增长",
"desc": "🔥 The API to search, scrape, and interact with the web for AI",
"effort": "安装已验证",
"forks": 7331,
"icon": "megaphone",
"name": "firecrawl 能力包",
"risk": "可发布",
"slug": "firecrawl",
"stars": 117823,
"tags": [
"浏览器 Agent",
"网页任务自动化",
"自然语言网页操作",
"多角色协作流程",
"结构化数据提取"
],
"thumb": "coral",
"type": "Skill Pack"
},
"manual": {
"markdown": "# https://github.com/firecrawl/firecrawl 项目说明书\n\n生成时间：2026-05-19 08:34:08 UTC\n\n## 目录\n\n- [Introduction to Firecrawl](#introduction)\n- [Project File Structure](#file-structure)\n- [System Architecture](#system-architecture)\n- [Search Functionality](#search-functionality)\n- [Web Scraper Engine](#scraper-engine)\n- [Agent and Deep Research](#agent-capabilities)\n- [Python SDK](#python-sdk)\n- [JavaScript/TypeScript SDK](#javascript-sdk)\n- [Other Language SDKs](#other-sdks)\n- [API v2 Endpoints](#api-v2-endpoints)\n\n\n\n## Introduction to Firecrawl\n\n### 相关页面\n\n相关主题：[System Architecture](#system-architecture), [Search Functionality](#search-functionality), [Web Scraper Engine](#scraper-engine)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/firecrawl/firecrawl/blob/main/README.md)\n- [apps/python-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/python-sdk/README.md)\n- [apps/js-sdk/firecrawl/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/js-sdk/firecrawl/README.md)\n- [apps/go-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/go-sdk/README.md)\n- [apps/java-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/java-sdk/README.md)\n- [apps/dot-net-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/dot-net-sdk/README.md)\n- [apps/ruby-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/ruby-sdk/README.md)\n \n\n# Introduction to Firecrawl\n\nFirecrawl is an intelligent web scraping and data extraction platform designed specifically for AI systems. It enables developers to search, scrape, and interact with the web through a unified API, supporting multiple programming languages through official SDKs.\n\n资料来源：[README.md](https://github.com/firecrawl/firecrawl/blob/main/README.md)\n\n## Core Features Overview\n\nFirecrawl provides four primary capabilities that form the foundation of its web interaction platform:\n\n### Search\n\nFind information across the web through Firecrawl's search functionality, allowing AI applications to locate relevant sources and data.\n\n资料来源：[README.md](https://github.com/firecrawl/firecrawl/blob/main/README.md)\n\n### Scrape\n\nExtract clean, structured data from any webpage. The scrape feature supports multiple output formats including markdown, HTML, and links, with options for full-page or main-content-only extraction.\n\n资料来源：[README.md](https://github.com/firecrawl/firecrawl/blob/main/README.md)\n\n### Interact\n\nClick, navigate, and operate on web pages programmatically. This feature enables complex workflows like filling forms, navigating through multi-step processes, and performing authenticated operations.\n\n资料来源：[README.md](https://github.com/firecrawl/firecrawl/blob/main/README.md)\n\n### Agent\n\nAutonomous data gathering through AI-powered agents that can intelligently navigate websites, extract relevant information, and handle complex research tasks.\n\n资料来源：[README.md](https://github.com/firecrawl/firecrawl/blob/main/README.md)\n\n## Architecture Overview\n\n```mermaid\ngraph TD\n A[Client Applications] --> B[Firecrawl API]\n B --> C[Search Service]\n B --> D[Scrape Service]\n B --> E[Crawl Service]\n B --> F[Agent Service]\n C --> G[Search Providers]\n D --> H[HTML Processing]\n E --> H\n H --> I[Markdown Conversion]\n I --> J[Structured Output]\n F --> K[LLM Integration]\n K --> D\n K --> E\n```\n\n## SDK Ecosystem\n\nFirecrawl provides official SDKs for multiple programming languages, enabling seamless integration across different technology stacks.\n\n资料来源：[apps/python-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/python-sdk/README.md)\n\n### SDK Comparison\n\n| Language | Package Name | Version | Min SDK/API Version | Installation |\n|----------|-------------|---------|---------------------|--------------|\n| Python | `firecrawl-sdk` | Latest | Python 3.8+ | `pip install firecrawl-sdk` |\n| JavaScript/TypeScript | `@mendable/firecrawl-js` | Latest | Node.js 18+ | `npm install @mendable/firecrawl-js` |\n| Go | `firecrawl` | v2 | Go 1.21+ | `go get github.com/firecrawl/firecrawl-go-sdk` |\n| Java | `firecrawl-java` | 1.6.0 | Java 11+ | Maven dependency |\n| .NET | `firecrawl-sdk` | Latest | .NET 6+ | `dotnet add package firecrawl-sdk` |\n| Ruby | `firecrawl` | Latest | Ruby 3.0+ | `gem install firecrawl` |\n\n资料来源：[apps/python-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/python-sdk/README.md), [apps/js-sdk/firecrawl/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/js-sdk/firecrawl/README.md), [apps/go-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/go-sdk/README.md), [apps/java-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/java-sdk/README.md), [apps/dot-net-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/dot-net-sdk/README.md), [apps/ruby-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/ruby-sdk/README.md)\n\n### Python SDK\n\n```python\nfrom firecrawl import Firecrawl\n\napp = Firecrawl(api_key=\"fc-YOUR_API_KEY\")\nresult = app.scrape('https://firecrawl.dev', formats=['markdown', 'html'])\n```\n\nThe Python SDK supports both synchronous and asynchronous operations, with v2 being the current major version and v1 available for legacy compatibility under `firecrawl.v1`.\n\n资料来源：[apps/python-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/python-sdk/README.md)\n\n### JavaScript/TypeScript SDK\n\n```javascript\nimport Firecrawl from '@mendable/firecrawl-js';\n\nconst app = new Firecrawl({ apiKey: \"fc-YOUR_API_KEY\" });\nconst result = await app.scrape('https://firecrawl.dev');\n```\n\n资料来源：[apps/js-sdk/firecrawl/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/js-sdk/firecrawl/README.md)\n\n### Go SDK\n\n```rust\nuse firecrawl::{Client, ScrapeOptions, Format, CrawlOptions};\n\nlet client = Client::new(\"fc-YOUR_API_KEY\")?;\nlet document = client.scrape(\"https://firecrawl.dev\", None).await?;\n```\n\n资料来源：[apps/go-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/go-sdk/README.md)\n\n### Java SDK\n\n```java\nFirecrawlClient client = FirecrawlClient.builder()\n .apiKey(\"fc-your-api-key\")\n .build();\n\nDocument doc = client.scrape(\"https://example.com\",\n ScrapeOptions.builder()\n .formats(List.of(\"markdown\"))\n .build());\n```\n\n资料来源：[apps/java-sdk/README.md](https://github.com/firecrawl/firecrawl/blob/main/apps/java-sdk/README.md)\n\n### .NET SDK\n\n```csharp\nvar client = new FirecrawlClient(\"fc-your-api-key\");\nvar doc = await client.ScrapeAsync(\"https://example.com\",\n new ScrapeOptions { Formats = new List