firecrawl-advanced-troubleshooting

Featured

Debug hard-to-diagnose Firecrawl issues with systematic isolation and evidence collection. Use when standard troubleshooting fails, investigating why scrapes return empty content, crawl jobs hang, or webhooks don't fire. Trigger with phrases like "firecrawl hard bug", "firecrawl mystery error", "firecrawl impossible to debug", "firecrawl deep debug", "firecrawl not scraping".

AI & Automation 2,266 stars 315 forks Updated today MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Firecrawl Advanced Troubleshooting ## Overview Deep debugging techniques for complex Firecrawl issues: empty scrapes on certain domains, crawl jobs that never complete, inconsistent extraction results, and webhook delivery failures. Uses systematic layer-by-layer isolation. ## Instructions ### Step 1: Minimal Reproduction ```typescript import FirecrawlApp from "@mendable/firecrawl-js"; // Strip everything down to the simplest failing case async function minimalRepro() { const firecrawl = new FirecrawlApp({ apiKey: process.env.FIRECRAWL_API_KEY!, }); // Test 1: Can we scrape at all? console.log("Test 1: Basic scrape"); const basic = await firecrawl.scrapeUrl("https://example.com", { formats: ["markdown"], }); console.log(` Success: ${basic.success}, Length: ${basic.markdown?.length}`); // Test 2: Does the target URL work? console.log("Test 2: Target URL"); const target = await firecrawl.scrapeUrl("https://YOUR-FAILING-URL.com", { formats: ["markdown"], }); console.log(` Success: ${target.success}, Length: ${target.markdown?.length}`); // Test 3: With waitFor for JS rendering console.log("Test 3: With JS wait"); const withWait = await firecrawl.scrapeUrl("https://YOUR-FAILING-URL.com", { formats: ["markdown"], waitFor: 10000, onlyMainContent: true, }); console.log(` Success: ${withWait.success}, Length: ${withWait.markdown?.length}`); // Test 4: With actions console.log("Test 4: With actions"); const w...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
7 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

firecrawl-hello-world

Create a minimal working Firecrawl example that scrapes a page to markdown. Use when starting a new Firecrawl integration, testing your setup, or learning the scrape/crawl/map/extract API surface. Trigger with phrases like "firecrawl hello world", "firecrawl example", "firecrawl quick start", "simple firecrawl code".

2,266 Updated today
jeremylongshore
AI & Automation Featured

firecrawl-reliability-patterns

Implement Firecrawl reliability patterns: circuit breakers, crawl fallbacks, and content validation. Use when building fault-tolerant scraping pipelines, implementing crawl-to-scrape fallback, or adding content quality gates to Firecrawl integrations. Trigger with phrases like "firecrawl reliability", "firecrawl circuit breaker", "firecrawl fallback", "firecrawl resilience", "firecrawl fault tolerant".

2,266 Updated today
jeremylongshore
AI & Automation Featured

firecrawl-performance-tuning

Optimize Firecrawl scraping performance with caching, batch scraping, and format selection. Use when experiencing slow scrapes, optimizing credit usage per page, or building high-throughput scraping pipelines. Trigger with phrases like "firecrawl performance", "optimize firecrawl", "firecrawl latency", "firecrawl caching", "firecrawl slow", "firecrawl batch".

2,266 Updated today
jeremylongshore
AI & Automation Featured

firecrawl-known-pitfalls

Identify and avoid Firecrawl anti-patterns and common integration mistakes. Use when reviewing Firecrawl code, onboarding new developers, or auditing existing integrations for best practices violations. Trigger with phrases like "firecrawl mistakes", "firecrawl anti-patterns", "firecrawl pitfalls", "firecrawl what not to do", "firecrawl code review".

2,266 Updated today
jeremylongshore
AI & Automation Featured

firecrawl-common-errors

Diagnose and fix Firecrawl common errors and API response codes. Use when encountering Firecrawl errors, debugging failed scrapes, or troubleshooting crawl job issues. Trigger with phrases like "firecrawl error", "fix firecrawl", "firecrawl not working", "debug firecrawl", "firecrawl 429", "firecrawl 402".

2,266 Updated today
jeremylongshore