Skip to content

Commit 5d035e9

Browse files
authored
Merge pull request #82 from firecrawl/feat/v2+streamablehttp
update to v2 and streamable http
2 parents 9837e19 + 0f28ac3 commit 5d035e9

File tree

6 files changed

+516
-960
lines changed

6 files changed

+516
-960
lines changed

.github/workflows/ci.yml

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,3 @@ jobs:
2727

2828
- name: Lint
2929
run: npm run lint
30-
31-
- name: Test
32-
run: npm test

README.md

Lines changed: 0 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -311,8 +311,6 @@ Use this guide to select the right tool for your task:
311311
- **If you want to search the web for info:** use **search**
312312
- **If you want to extract structured data:** use **extract**
313313
- **If you want to analyze a whole site or section:** use **crawl** (with limits!)
314-
- **If you want to do in-depth research:** use **deep_research**
315-
- **If you want to generate LLMs.txt:** use **generate_llmstxt**
316314

317315
### Quick Reference Table
318316

@@ -324,8 +322,6 @@ Use this guide to select the right tool for your task:
324322
| crawl | Multi-page extraction (with limits) | markdown/html[] |
325323
| search | Web search for info | results[] |
326324
| extract | Structured data from pages | JSON |
327-
| deep_research | In-depth, multi-source research | summary, sources|
328-
| generate_llmstxt | LLMs.txt for a domain | text |
329325

330326
## Available Tools
331327

@@ -629,78 +625,6 @@ When using a self-hosted instance, the extraction will use your configured LLM.
629625
}
630626
```
631627

632-
### 9. Deep Research Tool (`firecrawl_deep_research`)
633-
634-
Conduct deep web research on a query using intelligent crawling, search, and LLM analysis.
635-
636-
**Best for:**
637-
- Complex research questions requiring multiple sources, in-depth analysis.
638-
639-
**Not recommended for:**
640-
- Simple questions that can be answered with a single search
641-
- When you need very specific information from a known page (use scrape)
642-
- When you need results quickly (deep research can take time)
643-
644-
**Arguments:**
645-
- query (string, required): The research question or topic to explore.
646-
- maxDepth (number, optional): Maximum recursive depth for crawling/search (default: 3).
647-
- timeLimit (number, optional): Time limit in seconds for the research session (default: 120).
648-
- maxUrls (number, optional): Maximum number of URLs to analyze (default: 50).
649-
650-
**Prompt Example:**
651-
> "Research the environmental impact of electric vehicles versus gasoline vehicles."
652-
653-
**Usage Example:**
654-
```json
655-
{
656-
"name": "firecrawl_deep_research",
657-
"arguments": {
658-
"query": "What are the environmental impacts of electric vehicles compared to gasoline vehicles?",
659-
"maxDepth": 3,
660-
"timeLimit": 120,
661-
"maxUrls": 50
662-
}
663-
}
664-
```
665-
666-
**Returns:**
667-
- Final analysis generated by an LLM based on research. (data.finalAnalysis)
668-
- May also include structured activities and sources used in the research process.
669-
670-
### 10. Generate LLMs.txt Tool (`firecrawl_generate_llmstxt`)
671-
672-
Generate a standardized llms.txt (and optionally llms-full.txt) file for a given domain. This file defines how large language models should interact
673-
with the site.
674-
675-
**Best for:**
676-
- Creating machine-readable permission guidelines for AI models.
677-
678-
**Not recommended for:**
679-
- General content extraction or research
680-
681-
**Arguments:**
682-
- url (string, required): The base URL of the website to analyze.
683-
- maxUrls (number, optional): Max number of URLs to include (default: 10).
684-
- showFullText (boolean, optional): Whether to include llms-full.txt contents in the response.
685-
686-
**Prompt Example:**
687-
> "Generate an LLMs.txt file for example.com."
688-
689-
**Usage Example:**
690-
```json
691-
{
692-
"name": "firecrawl_generate_llmstxt",
693-
"arguments": {
694-
"url": "https://example.com",
695-
"maxUrls": 20,
696-
"showFullText": true
697-
}
698-
}
699-
```
700-
701-
**Returns:**
702-
- LLMs.txt file contents (and optionally llms-full.txt)
703-
704628
## Logging System
705629

706630
The server includes comprehensive logging:

package-lock.json

Lines changed: 45 additions & 30 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "firecrawl-mcp",
3-
"version": "1.12.0",
4-
"description": "MCP server for Firecrawl web scraping integration. Supports both cloud and self-hosted instances. Features include web scraping, batch processing, structured data extraction, and LLM-powered content analysis.",
3+
"version": "2.0.2",
4+
"description": "MCP server for Firecrawl web scraping integration. Supports both cloud and self-hosted instances. Features include web scraping, search, batch processing, structured data extraction, and LLM-powered content analysis.",
55
"type": "module",
66
"bin": {
77
"firecrawl-mcp": "dist/index.js"
@@ -20,15 +20,17 @@
2020
"lint:fix": "eslint src/**/*.ts --fix",
2121
"format": "prettier --write .",
2222
"prepare": "npm run build",
23-
"publish": "npm run build && npm publish"
23+
"publish": "npm run build && npm publish",
24+
"publish-beta": "npm run build && npm publish --tag beta"
2425
},
2526
"license": "MIT",
2627
"dependencies": {
27-
"@mendable/firecrawl-js": "^1.19.0",
28-
"@modelcontextprotocol/sdk": "^1.4.1",
28+
"@mendable/firecrawl-js": "^3.0.3",
29+
"@modelcontextprotocol/sdk": "^1.17.3",
2930
"dotenv": "^16.4.7",
3031
"express": "^5.1.0",
3132
"shx": "^0.3.4",
33+
"typescript": "^5.9.2",
3234
"ws": "^8.18.1"
3335
},
3436
"devDependencies": {
@@ -43,8 +45,7 @@
4345
"jest": "^29.7.0",
4446
"jest-mock-extended": "^4.0.0-beta1",
4547
"prettier": "^3.1.1",
46-
"ts-jest": "^29.1.1",
47-
"typescript": "^5.3.3"
48+
"ts-jest": "^29.1.1"
4849
},
4950
"engines": {
5051
"node": ">=18.0.0"

0 commit comments

Comments
 (0)