firecrawl_check_batch_status
Monitor the progress and completion status of web scraping batch jobs to track data extraction workflows.
Instructions
Check the status of a batch scraping job.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Batch job ID to check |
Implementation Reference
- src/index.ts:1032-1066 (handler)The handler case for the firecrawl_check_batch_status tool. Validates input using isStatusCheckOptions, retrieves the batch operation from the in-memory batchOperations map by ID, constructs a status message with progress, error, or results, and returns it.case 'firecrawl_check_batch_status': { if (!isStatusCheckOptions(args)) { throw new Error( 'Invalid arguments for firecrawl_check_batch_status' ); } const operation = batchOperations.get(args.id); if (!operation) { return { content: [ { type: 'text', text: `No batch operation found with ID: ${args.id}`, }, ], isError: true, }; } const status = `Batch Status: Status: ${operation.status} Progress: ${operation.progress.completed}/${operation.progress.total} ${operation.error ? `Error: ${operation.error}` : ''} ${ operation.result ? `Results: ${JSON.stringify(operation.result, null, 2)}` : '' }`; return { content: [{ type: 'text', text: status }], isError: false, }; }
- src/index.ts:378-391 (schema)The Tool object definition providing the schema for firecrawl_check_batch_status, including name, description, and inputSchema requiring a 'id' string.const CHECK_BATCH_STATUS_TOOL: Tool = { name: 'firecrawl_check_batch_status', description: 'Check the status of a batch scraping job.', inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Batch job ID to check', }, }, required: ['id'], }, };
- src/index.ts:862-873 (registration)Registration of all tools including CHECK_BATCH_STATUS_TOOL in the listTools request handler.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ SCRAPE_TOOL, MAP_TOOL, CRAWL_TOOL, BATCH_SCRAPE_TOOL, CHECK_BATCH_STATUS_TOOL, CHECK_CRAWL_STATUS_TOOL, SEARCH_TOOL, EXTRACT_TOOL, DEEP_RESEARCH_TOOL, ],
- src/index.ts:649-656 (helper)Type guard helper function used in the handler to validate arguments for status check tools like firecrawl_check_batch_status.function isStatusCheckOptions(args: unknown): args is StatusCheckOptions { return ( typeof args === 'object' && args !== null && 'id' in args && typeof (args as { id: unknown }).id === 'string' ); }
- src/index.ts:557-559 (helper)TypeScript interface defining the expected arguments shape for status check tools.interface StatusCheckOptions { id: string; }