FireCrawl CI Integration
Overview
Set up CI/CD pipelines for FireCrawl integrations with automated testing.
Prerequisites
- •GitHub repository with Actions enabled
- •FireCrawl test API key
- •npm/pnpm project configured
Instructions
Step 1: Create GitHub Actions Workflow
Create .github/workflows/firecrawl-integration.yml:
yaml
name: FireCrawl Integration Tests
on:
push:
branches: [main]
pull_request:
branches: [main]
env:
FIRECRAWL_API_KEY: ${{ secrets.FIRECRAWL_API_KEY }}
jobs:
test:
runs-on: ubuntu-latest
env:
FIRECRAWL_API_KEY: ${{ secrets.FIRECRAWL_API_KEY }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
- run: npm ci
- run: npm test -- --coverage
- run: npm run test:integration
Step 2: Configure Secrets
bash
gh secret set FIRECRAWL_API_KEY --body "sk_test_***"
Step 3: Add Integration Tests
typescript
describe('FireCrawl Integration', () => {
it.skipIf(!process.env.FIRECRAWL_API_KEY)('should connect', async () => {
const client = getFireCrawlClient();
const result = await client.healthCheck();
expect(result.status).toBe('ok');
});
});
Output
- •Automated test pipeline
- •PR checks configured
- •Coverage reports uploaded
- •Release workflow ready
Error Handling
| Issue | Cause | Solution |
|---|---|---|
| Secret not found | Missing configuration | Add secret via gh secret set |
| Tests timeout | Network issues | Increase timeout or mock |
| Auth failures | Invalid key | Check secret value |
Examples
Release Workflow
yaml
on:
push:
tags: ['v*']
jobs:
release:
runs-on: ubuntu-latest
env:
FIRECRAWL_API_KEY: ${{ secrets.FIRECRAWL_API_KEY_PROD }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
- run: npm ci
- name: Verify FireCrawl production readiness
run: npm run test:integration
- run: npm run build
- run: npm publish
Branch Protection
yaml
required_status_checks: - "test" - "firecrawl-integration"
Resources
Next Steps
For deployment patterns, see firecrawl-deploy-integration.