firecrawl_check_crawl_status
Check the status and progress of a crawl job, returning results when complete.
Instructions
Check the status of a crawl job.
Usage Example:
{
"name": "firecrawl_check_crawl_status",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}Returns: Status and progress of the crawl job, including results if available.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Crawl job ID to check |
Implementation Reference
- src/index.ts:380-406 (schema)CHECK_CRAWL_STATUS_TOOL definition with name 'firecrawl_check_crawl_status', description, and inputSchema requiring 'id' (string) parameter.
const CHECK_CRAWL_STATUS_TOOL: Tool = { name: 'firecrawl_check_crawl_status', description: ` Check the status of a crawl job. **Usage Example:** \`\`\`json { "name": "firecrawl_check_crawl_status", "arguments": { "id": "550e8400-e29b-41d4-a716-446655440000" } } \`\`\` **Returns:** Status and progress of the crawl job, including results if available. `, inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Crawl job ID to check', }, }, required: ['id'], }, }; - src/index.ts:720-722 (helper)StatusCheckOptions interface defining the 'id' string property for type safety.
interface StatusCheckOptions { id: string; } - src/index.ts:805-812 (helper)isStatusCheckOptions type guard function that validates the arguments object has a string 'id' property.
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:955-966 (registration)ListToolsRequestSchema handler registers CHECK_CRAWL_STATUS_TOOL in the tools array alongside other tools.
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ SCRAPE_TOOL, MAP_TOOL, CRAWL_TOOL, CHECK_CRAWL_STATUS_TOOL, SEARCH_TOOL, EXTRACT_TOOL, DEEP_RESEARCH_TOOL, GENERATE_LLMSTXT_TOOL, ], })); - src/index.ts:1129-1149 (handler)Handler for 'firecrawl_check_crawl_status' case: validates args via isStatusCheckOptions, calls client.checkCrawlStatus(args.id), formats response with status/progress/results, and returns the result.
case 'firecrawl_check_crawl_status': { if (!isStatusCheckOptions(args)) { throw new Error('Invalid arguments for firecrawl_check_crawl_status'); } const response = await client.checkCrawlStatus(args.id); if (!response.success) { throw new Error(response.error); } const status = `Crawl Status: Status: ${response.status} Progress: ${response.completed}/${response.total} Credits Used: ${response.creditsUsed} Expires At: ${response.expiresAt} ${ response.data.length > 0 ? '\nResults:\n' + formatResults(response.data) : '' }`; return { content: [{ type: 'text', text: trimResponseText(status) }], isError: false, }; }