Firecrawl Prod Checklist

DevOps & Security

firecrawl-prod-checklist

Firecrawl Prod Checklist is an Agent Skill for devops & security published in the Dicklesworthstone/pi_agent_rust repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Execute FireCrawl production deployment checklist and rollback procedures. Use when deploying FireCrawl integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "firecrawl production", "deploy firecrawl", "firecrawl go-live", "firecrawl launch checklist".

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/Dicklesworthstone/pi_agent_rust/blob/HEAD/tests/ext_conformance/artifacts/plugins-community/plugins/saas-packs/firecrawl-pack/skills/firecrawl-prod-checklist/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/firecrawl-prod-checklist, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

FireCrawl Production Checklist

Overview

Complete checklist for deploying FireCrawl integrations to production.

Prerequisites

Staging environment tested and verified
Production API keys available
Deployment pipeline configured
Monitoring and alerting ready

Instructions

Step 1: Pre-Deployment Configuration

Production API keys in secure vault
Environment variables set in deployment platform
API key scopes are minimal (least privilege)
Webhook endpoints configured with HTTPS
Webhook secrets stored securely

Step 2: Code Quality Verification

All tests passing (npm test)
No hardcoded credentials
Error handling covers all FireCrawl error types
Rate limiting/backoff implemented
Logging is production-appropriate

Step 3: Infrastructure Setup

Health check endpoint includes FireCrawl connectivity
Monitoring/alerting configured
Circuit breaker pattern implemented
Graceful degradation configured

Step 4: Documentation Requirements

Incident runbook created
Key rotation procedure documented
Rollback procedure documented
On-call escalation path defined

Step 5: Deploy with Gradual Rollout

# Pre-flight checks
curl -f https://staging.example.com/health
curl -s https://status.firecrawl.com

# Gradual rollout - start with canary (10%)
kubectl apply -f k8s/production.yaml
kubectl set image deployment/firecrawl-integration app=image:new --record
kubectl rollout pause deployment/firecrawl-integration

# Monitor canary traffic for 10 minutes
sleep 600
# Check error rates and latency before continuing

# If healthy, continue rollout to 50%
kubectl rollout resume deployment/firecrawl-integration
kubectl rollout pause deployment/firecrawl-integration
sleep 300

# Complete rollout to 100%
kubectl rollout resume deployment/firecrawl-integration
kubectl rollout status deployment/firecrawl-integration

Output

Deployed FireCrawl integration
Health checks passing
Monitoring active
Rollback procedure documented

Error Handling

Alert	Condition	Severity
API Down	5xx errors > 10/min	P1
High Latency	p99 > 5000ms	P2
Rate Limited	429 errors > 5/min	P2
Auth Failures	401/403 errors > 0	P1

Examples

Health Check Implementation

async function healthCheck(): Promise<{ status: string; firecrawl: any }> {
  const start = Date.now();
  try {
    await firecrawlClient.ping();
    return { status: 'healthy', firecrawl: { connected: true, latencyMs: Date.now() - start } };
  } catch (error) {
    return { status: 'degraded', firecrawl: { connected: false, latencyMs: Date.now() - start } };
  }
}

Immediate Rollback

kubectl rollout undo deployment/firecrawl-integration
kubectl rollout status deployment/firecrawl-integration

Resources

Next Steps

For version upgrades, see firecrawl-upgrade-migration.