Debug Firecrawl with Ask

curl -X POST https://api.firecrawl.dev/v2/support/ask \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "question": "my crawl returned 3 pages but I expected 50"  }'

curl -X POST https://api.firecrawl.dev/v2/support/docs-search \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "question": "how do I set up webhook signature verification?"  }'

curl -X POST https://api.firecrawl.dev/v2/support/ask \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "question": "debug failed job 0f8c9a1b-4e2d-47a1-9c3f-1b2d3e4f5a6b — crawl of https://example.com failed after 12 pages",    "rationale": "user needs the full docs site indexed before their demo"  }'

import requestsFIRECRAWL_API_KEY = "fc-YOUR_API_KEY"def diagnose_firecrawl_issue(question, rationale=None):    """Call the Firecrawl Ask API to debug an issue."""    payload = {"question": question}    if rationale:        payload["rationale"] = rationale    response = requests.post(        "https://api.firecrawl.dev/v2/support/ask",        headers={            "Authorization": f"Bearer {FIRECRAWL_API_KEY}",            "Content-Type": "application/json",        },        json=payload,    )    return response.json()# Example: debug a scrape that returned empty contentresult = diagnose_firecrawl_issue(    question="scrape returned empty markdown for https://example.com",    rationale="user needs product pricing data for competitive analysis",)print(result["answer"])print(result["fixParameters"])  # e.g., {"waitFor": 5000, "actions": [...]}print(result["confidence"])     # "high", "medium", or "low"

async function diagnoseFirecrawlIssue(question, rationale) {  const response = await fetch(    "https://api.firecrawl.dev/v2/support/ask",    {      method: "POST",      headers: {        Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY}`,        "Content-Type": "application/json",      },      body: JSON.stringify({ question, rationale }),    }  );  return response.json();}// Example: debug a crawl that stopped earlyconst result = await diagnoseFirecrawlIssue(  "my crawl returned 3 pages but I expected 50",  "user is on their third failed crawl attempt today");console.log(result.answer);console.log(result.fixParameters);

from firecrawl import Firecrawlclient = Firecrawl(api_key="fc-YOUR_API_KEY")# Step 1: Try the scrapedoc = client.scrape("https://example.com/pricing", formats=["markdown"])if not doc.markdown or len(doc.markdown) < 100:    # Step 2: Ask for help debugging    diagnosis = diagnose_firecrawl_issue(        question=f"scrape returned only {len(doc.markdown or '')} chars of markdown for https://example.com/pricing",    )    # Step 3: Apply fix parameters and retry    if diagnosis.get("fixParameters"):        doc = client.scrape(            "https://example.com/pricing",            formats=["markdown"],            **diagnosis["fixParameters"],        )

{  "requestId": "req_...",  "answer": "<2-4 sentence prose diagnosis of the issue plus the recommended fix.>",  "confidence": "high",  "fixParameters": { "<param>": "<value>" },  "validation": {    "tested": true,    "result": "success",    "evidence": "<short summary of the validation tool call the agent ran to confirm the fix>"  },  "feedback": null,  "durationMs": 18432}

{  "requestId": "req_...",  "answer": "The signature is sent in the X-Firecrawl-Signature header...",  "evidence": [    { "pathOrUrl": "webhooks/security.mdx#L1-L52", "reason": "..." }  ],  "usage": { "inputTokens": 4356, "outputTokens": 688, "totalTokens": 5044 },  "durationMs": 11252}