feat(tools): added new firecrawl agent endpoint

[waleedlatif1]

Summary

• added new firecrawl agent endpoint

Type of Change

• New feature

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview, Comment	Dec 27, 2025 4:30am

[greptile-apps]

Greptile Summary

Added a new firecrawl agent endpoint that enables autonomous web data extraction using natural language prompts.

• Implemented firecrawl_agent tool with async job polling (5-minute timeout, 5-second intervals)
• Added comprehensive UI configuration in FirecrawlBlock with agent prompt, optional URLs, JSON schema, and credit controls
• Registered the new tool in the tools registry
• Added documentation for the new endpoint
• Includes unrelated documentation cleanup for intercom, pinecone, supabase, and typeform tools
• Added SlackMonoIcon component (unrelated to main feature)

Confidence Score: 4/5

• This PR is safe to merge with one minor documentation fix needed
• The implementation follows established patterns from existing firecrawl tools (extract, crawl) and includes proper error handling, polling logic, and type safety. Only issue found is a documentation type mismatch for the sources field. The PR also includes unrelated documentation updates which don't affect the core feature.
• apps/docs/content/docs/en/tools/firecrawl.mdx requires a minor fix to correct the sources field type from object to array

Important Files Changed

Filename	Overview
apps/sim/tools/firecrawl/agent.ts	New firecrawl agent tool with polling logic for async job completion
apps/sim/tools/registry.ts	Registered firecrawl_agent tool in the tools registry
apps/sim/blocks/blocks/firecrawl.ts	Added agent operation UI configuration with prompt, URLs, schema, and credit controls
apps/docs/content/docs/en/tools/firecrawl.mdx	Added documentation for firecrawl_agent endpoint, minor type issue with sources field

Sequence Diagram

sequenceDiagram
    participant User
    participant FirecrawlBlock
    participant AgentTool
    participant FirecrawlAPI
    
    User->>FirecrawlBlock: Configure agent operation
    User->>FirecrawlBlock: Set agentPrompt, urls, schema
    FirecrawlBlock->>AgentTool: Execute with params
    
    AgentTool->>FirecrawlAPI: POST /v2/agent
    Note over AgentTool,FirecrawlAPI: Send prompt, urls, schema, maxCredits
    FirecrawlAPI-->>AgentTool: Return jobId
    
    loop Poll every 5 seconds (max 5 minutes)
        AgentTool->>FirecrawlAPI: GET /v2/agent/{jobId}
        FirecrawlAPI-->>AgentTool: Return status
        
        alt status === 'completed'
            AgentTool->>AgentTool: Extract data, creditsUsed, sources
            AgentTool-->>FirecrawlBlock: Return success with data
            FirecrawlBlock-->>User: Display extracted data
        else status === 'failed'
            AgentTool-->>FirecrawlBlock: Return error
            FirecrawlBlock-->>User: Show error message
        else status === 'processing'
            AgentTool->>AgentTool: Wait 5 seconds
        end
    end
    
    alt Timeout after 5 minutes
        AgentTool-->>FirecrawlBlock: Return timeout error
        FirecrawlBlock-->>User: Show timeout message
    end

Loading

[greptile-apps]

_{11 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}