How do I install the Firecrawl Debug Bundle skill?

Run npx skillmds@latest add micsapp/firecrawl-debug-bundle in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Firecrawl Debug Bundle safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Firecrawl Debug Bundle?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Firecrawl Debug Bundle free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Firecrawl Debug Bundle?

micsapp (@micsapp) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Firecrawl Debug Bundle by micsapp — Agent Skill

Name: Firecrawl Debug Bundle
Rating: 4.2 (5 reviews)
Author: micsapp

Firecrawl Debug Bundle

Collect FireCrawl debug evidence for support tickets and troubleshooting. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for FireCrawl problems. Trigger with phrases like "firecrawl debug", "firecrawl support bundle", "collect firecrawl logs", "firecrawl diagnostic".

micsapp Updated Sep 8, 2026 3 repo stars

File contents

FireCrawl Debug Bundle

Overview

Collect all necessary diagnostic information for FireCrawl support tickets.

Prerequisites

FireCrawl SDK installed
Access to application logs
Permission to collect environment info

Instructions

Step 1: Create Debug Bundle Script

#!/bin/bash
# firecrawl-debug-bundle.sh

BUNDLE_DIR="firecrawl-debug-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE_DIR"

echo "=== FireCrawl Debug Bundle ===" > "$BUNDLE_DIR/summary.txt"
echo "Generated: $(date)" >> "$BUNDLE_DIR/summary.txt"

Step 2: Collect Environment Info

set -euo pipefail
# Environment info
echo "--- Environment ---" >> "$BUNDLE_DIR/summary.txt"
node --version >> "$BUNDLE_DIR/summary.txt" 2>&1
npm --version >> "$BUNDLE_DIR/summary.txt" 2>&1
echo "FIRECRAWL_API_KEY: ${FIRECRAWL_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"

Step 3: Gather SDK and Logs

set -euo pipefail
# SDK version
npm list @firecrawl/sdk 2>/dev/null >> "$BUNDLE_DIR/summary.txt"

# Recent logs (redacted)
grep -i "firecrawl" ~/.npm/_logs/*.log 2>/dev/null | tail -50 >> "$BUNDLE_DIR/logs.txt"

# Configuration (redacted - secrets masked)
echo "--- Config (redacted) ---" >> "$BUNDLE_DIR/summary.txt"
cat .env 2>/dev/null | sed 's/=.*/=***REDACTED***/' >> "$BUNDLE_DIR/config-redacted.txt"

# Network connectivity test
echo "--- Network Test ---" >> "$BUNDLE_DIR/summary.txt"
echo -n "API Health: " >> "$BUNDLE_DIR/summary.txt"
curl -s -o /dev/null -w "%{http_code}" https://api.firecrawl.com/health >> "$BUNDLE_DIR/summary.txt"
echo "" >> "$BUNDLE_DIR/summary.txt"

Step 4: Package Bundle

tar -czf "$BUNDLE_DIR.tar.gz" "$BUNDLE_DIR"
echo "Bundle created: $BUNDLE_DIR.tar.gz"

Output

firecrawl-debug-YYYYMMDD-HHMMSS.tar.gz archive containing:
- summary.txt - Environment and SDK info
- logs.txt - Recent redacted logs
- config-redacted.txt - Configuration (secrets removed)

Error Handling

Item	Purpose	Included
Environment versions	Compatibility check	✓
SDK version	Version-specific bugs	✓
Error logs (redacted)	Root cause analysis	✓
Config (redacted)	Configuration issues	✓
Network test	Connectivity issues	✓

Examples

Sensitive Data Handling

ALWAYS REDACT:

API keys and tokens
Passwords and secrets
PII (emails, names, IDs)

Safe to Include:

Error messages
Stack traces (redacted)
SDK/runtime versions

Submit to Support

Create bundle: bash firecrawl-debug-bundle.sh
Review for sensitive data
Upload to FireCrawl support portal

Resources

Next Steps

For rate limit issues, see firecrawl-rate-limits.

---name: firecrawl-debug-bundledescription: Collect FireCrawl debug evidence for support tickets and troubleshooting. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for FireCrawl problems. Trigger with phrases like "firecrawl debug", "firecrawl support bundle", "collect firecrawl logs", "firecrawl diagnostic".license: MIT---# FireCrawl Debug Bundle## OverviewCollect all necessary diagnostic information for FireCrawl support tickets.## Prerequisites- FireCrawl SDK installed- Access to application logs- Permission to collect environment info## Instructions### Step 1: Create Debug Bundle Script```bash#!/bin/bash# firecrawl-debug-bundle.shBUNDLE_DIR="firecrawl-debug-$(date +%Y%m%d-%H%M%S)"mkdir -p "$BUNDLE_DIR"echo "=== FireCrawl Debug Bundle ===" > "$BUNDLE_DIR/summary.txt"echo "Generated: $(date)" >> "$BUNDLE_DIR/summary.txt"```### Step 2: Collect Environment Info```bashset -euo pipefail# Environment infoecho "--- Environment ---" >> "$BUNDLE_DIR/summary.txt"node --version >> "$BUNDLE_DIR/summary.txt" 2>&1npm --version >> "$BUNDLE_DIR/summary.txt" 2>&1echo "FIRECRAWL_API_KEY: ${FIRECRAWL_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"```### Step 3: Gather SDK and Logs```bashset -euo pipefail# SDK versionnpm list @firecrawl/sdk 2>/dev/null >> "$BUNDLE_DIR/summary.txt"# Recent logs (redacted)grep -i "firecrawl" ~/.npm/_logs/*.log 2>/dev/null | tail -50 >> "$BUNDLE_DIR/logs.txt"# Configuration (redacted - secrets masked)echo "--- Config (redacted) ---" >> "$BUNDLE_DIR/summary.txt"cat .env 2>/dev/null | sed 's/=.*/=***REDACTED***/' >> "$BUNDLE_DIR/config-redacted.txt"# Network connectivity testecho "--- Network Test ---" >> "$BUNDLE_DIR/summary.txt"echo -n "API Health: " >> "$BUNDLE_DIR/summary.txt"curl -s -o /dev/null -w "%{http_code}" https://api.firecrawl.com/health >> "$BUNDLE_DIR/summary.txt"echo "" >> "$BUNDLE_DIR/summary.txt"```### Step 4: Package Bundle```bashtar -czf "$BUNDLE_DIR.tar.gz" "$BUNDLE_DIR"echo "Bundle created: $BUNDLE_DIR.tar.gz"```## Output- `firecrawl-debug-YYYYMMDD-HHMMSS.tar.gz` archive containing: - `summary.txt` - Environment and SDK info - `logs.txt` - Recent redacted logs - `config-redacted.txt` - Configuration (secrets removed)## Error Handling| Item | Purpose | Included ||------|---------|----------|| Environment versions | Compatibility check | ✓ || SDK version | Version-specific bugs | ✓ || Error logs (redacted) | Root cause analysis | ✓ || Config (redacted) | Configuration issues | ✓ || Network test | Connectivity issues | ✓ |## Examples### Sensitive Data Handling**ALWAYS REDACT:**- API keys and tokens- Passwords and secrets- PII (emails, names, IDs)**Safe to Include:**- Error messages- Stack traces (redacted)- SDK/runtime versions### Submit to Support1. Create bundle: `bash firecrawl-debug-bundle.sh`2. Review for sensitive data3. Upload to FireCrawl support portal## Resources- [FireCrawl Support](https://docs.firecrawl.com/support)- [FireCrawl Status](https://status.firecrawl.com)## Next StepsFor rate limit issues, see `firecrawl-rate-limits`.

Frequently asked questions