You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f944c10
Browse filesBrowse the repository at this point in the historyBrowse files
feat(firecrawl): sync skills with the current hosted MCP tools (0.5.0)
The skills now discover and run Alexandria data providers with
alexandria_library_search and alexandria_library_read, route people and
company work to people_company_search and people_company_enrich, read a
known page and extract fields from it instead of requesting a JSON
schema, and carry the current billing and feedback guidance. Every tool
they name is on the full hosted surface at /v2/mcp-oauth.
mcp.json adds an X-Firecrawl-Origin header naming the plugin; it holds
no credential. The plugin, README and marketplace entry mention people
and company search and enrichment.
Copy file name to clipboardExpand all lines: .factory-plugin/marketplace.json
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -56,7 +56,7 @@
56
56
},
57
57
{
58
58
"name": "firecrawl",
59
-
"description": "Official Firecrawl plugin: search the web, scrape pages into clean Markdown or structured data, crawl and map sites, interact with dynamic pages, monitor changes, and research code, US law, and scientific papers through Firecrawl's hosted MCP server, with browser sign-in from /mcp",
59
+
"description": "Official Firecrawl plugin: search the web, scrape pages into clean Markdown or structured data, crawl and map sites, interact with dynamic pages, monitor changes, find and enrich people and companies, and research code, US law, and scientific papers through Firecrawl's hosted MCP server, with browser sign-in from /mcp",
Copy file name to clipboardExpand all lines: plugins/firecrawl/.factory-plugin/plugin.json
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
{
2
2
"name": "firecrawl",
3
-
"description": "Search the web, scrape pages into clean Markdown or structured data, crawl and map sites, interact with dynamic pages, monitor changes, and research code, US law, and scientific papers with Firecrawl",
4
-
"version": "0.4.0",
3
+
"description": "Search the web, scrape pages into clean Markdown or structured data, crawl and map sites, interact with dynamic pages, monitor changes, find and enrich people and companies, and research code, US law, and scientific papers with Firecrawl",
Copy file name to clipboardExpand all lines: plugins/firecrawl/README.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# firecrawl
2
2
3
-
Official [Firecrawl](https://firecrawl.dev) plugin for Droid. It connects Firecrawl's hosted MCP server, which gives the agent the full Firecrawl toolset: web search, page scraping into clean Markdown or structured data, site mapping and crawling, browser interaction on dynamic pages, local document parsing, change monitoring, Alexandria data providers, and dedicated search over developer docs and repositories, US government sources, and scientific papers.
3
+
Official [Firecrawl](https://firecrawl.dev) plugin for Droid. It connects Firecrawl's hosted MCP server, which gives the agent the full Firecrawl toolset: web search, page scraping into clean Markdown or structured data, site mapping and crawling, browser interaction on dynamic pages, local document parsing, change monitoring, Alexandria data providers, people and company search and enrichment, and dedicated search over developer docs and repositories, US government sources, and scientific papers.
4
4
5
5
## Install
6
6
@@ -12,12 +12,12 @@ Then connect your Firecrawl account: open `/mcp`, select the `firecrawl` server,
12
12
13
13
## Skills
14
14
15
-
-`firecrawl` - Choose the right Firecrawl operation for a request: search, scrape, map, crawl, interact, parse, monitor, Alexandria providers, and developer, government, and paper research
15
+
-`firecrawl` - Choose the right Firecrawl operation for a request: search, scrape, map, crawl, interact, parse, monitor, Alexandria providers, people and company lookups, and developer, government, and paper research
16
16
-`firecrawl-deep-research` - Investigate complex questions across many sources and return a cited answer, report, or table
17
17
18
18
## MCP server
19
19
20
-
`mcp.json` registers one HTTP server, `firecrawl`, at `https://mcp.firecrawl.dev/v2/mcp-oauth`. It uses OAuth: authenticate it from `/mcp`, and use `/mcp` again to clear or redo the sign-in.
20
+
`mcp.json` registers one HTTP server, `firecrawl`, at `https://mcp.firecrawl.dev/v2/mcp-oauth`, with an `X-Firecrawl-Origin` header that names this plugin and carries no credential. It uses OAuth: authenticate it from `/mcp`, and use `/mcp` again to clear or redo the sign-in.
Copy file name to clipboardExpand all lines: plugins/firecrawl/skills/firecrawl-deep-research/SKILL.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ Start from supplied URLs or reusable evidence. Otherwise use the fitting dedicat
18
18
19
19
When `firecrawl_search` exposes `objective`, set it to `[deep-research]` followed by the broader research goal, keeping that goal consistent across related searches. Keep `query` focused on the specific evidence needed, without the marker. Omit `objective` if the live schema does not support it, and avoid sensitive information in the goal.
20
20
21
-
A catalogue suggestion is not retrieved data. Reuse complete contracts; expand incomplete selected suggestions through `firecrawl_find_tools`. Use targeted catalogue discovery when structured evidence is needed and search provides no fitting suggestion. Avoid catalogue walks and unnecessary discovery before known pages or paper tools.
21
+
A catalogue suggestion is not retrieved data. Reuse complete contracts; read the contract of an incomplete selected suggestion through `alexandria_library_search`. Use targeted library discovery when structured evidence is needed and search provides no fitting suggestion. Avoid catalogue walks and unnecessary discovery before known pages or paper tools.
22
22
23
23
## Collection and costs
24
24
@@ -35,8 +35,10 @@ Choose the method most likely to resolve the highest-impact missing fact. Retrie
35
35
| Needed evidence | Method |
36
36
|---|---|
37
37
| Web sources and matching structured capabilities |`firecrawl_search`|
38
-
| Missing contract or targeted capability discovery |`firecrawl_find_tools`|
39
-
| Known page, passage or Alexandria execution |`firecrawl_scrape`|
38
+
| Missing contract or targeted capability discovery |`alexandria_library_search`|
39
+
| People and company records |`people_company_search`, `people_company_enrich`, when exposed |
| Primary US legal/regulatory text |`firecrawl_gov_search`, when exposed |
@@ -50,9 +52,9 @@ Reuse returned full text and directly supporting passages. Search excerpts guide
50
52
51
53
Prefer fitting records for comparable financial fields and requested enrichment when coverage, access and cost fit. Check entity type, geography, marketplace and date coverage, not merely topic similarity. Discover missing entity IDs instead of guessing them.
52
54
53
-
Follow selected `nextTool.arguments`, preserving selectors. Expand options and responses when supported, commonly `expand: ["options", "response"]`. A combined catalogue ID is not necessarily an execution selector. Inspect required inputs, `requiresOneOf`, response paths such as `response.key`, pagination, freshness, price and external effects. Catalogue pagination returns contracts, not records.
55
+
Read the selected contract with `alexandria_library_search`, commonly `cat /library/<category>/<provider>/<capability>.md`; the file path gives the provider and capability selectors. A combined catalogue ID is not necessarily an execution selector. Inspect required inputs, `requiresOneOf`, response paths such as `response.key`, pagination, freshness, price and external effects. Library commands return contracts, not records.
54
56
55
-
Execute returned provider/capability/options through `firecrawl_scrape` Alexandria mode, commonly `alexandria: {provider, capability, options}`. Batch and pin versions only as the live schema permits. Supported payload-bound `requestId` and millisecond `timeout`are separate from URL formats and `maxAge`. Inspect every `data.alexandria` item despite outer success; distinguish errors, empty results, partial output and unknown freshness. Page only with declared inputs, unchanged filters and bounded pages, records and credits.
57
+
Execute the selected provider/capability/options through `alexandria_library_read`, commonly `calls: [{provider, capability, options}]`. Batch and pin versions only as the live schema permits. Its payload-bound `requestId` and millisecond `timeout`cover the whole request. Inspect every `data.alexandria` item despite outer success; distinguish errors, empty results, partial output and unknown freshness. Page only with declared inputs, unchanged filters and bounded pages, records and credits.
56
58
57
59
For uncertain retries, retain identical request ID and payload; changed inputs require a new ID. Do not duplicate in-flight requests or replay successful batch items to recover failures. Use documented item-specific continuation. Stop unresolved access, terms or budget routes while preserving successes and continuing permitted routes. Provider terms require an organization administrator outside this workflow. Resume retained requests after confirmed acceptance only when contract, access and budget permit. Do not rerun paid work silently when retention expires.
58
60
@@ -103,20 +105,18 @@ Arguments for `firecrawl_search` when researching a web-policy angle; replace th
103
105
}
104
106
```
105
107
106
-
Arguments for `firecrawl_find_tools` only if the report needs structured observations:
108
+
Arguments for `alexandria_library_search` only if the report needs structured observations:
107
109
108
110
```json
109
111
{
110
-
"name": "firecrawl_find_tools",
112
+
"name": "alexandria_library_search",
111
113
"arguments": {
112
-
"query": "electricity generation observations by country year with units and source dates",
113
-
"limit": 3,
114
-
"expand": []
114
+
"command": "grep -ril \"electricity generation\" /library | head -20"
115
115
}
116
116
}
117
117
```
118
118
119
-
These return evidence candidates or catalogue summaries, not executed provider records. For a selected summary, copy its returned provider and capability IDs into a targeted `firecrawl_find_tools` call with `expand: ["options", "response"]`; build execution options from that contract. Do not invent a provider, capability, or field to make an example executable.
119
+
These return evidence candidates or library file paths, not executed provider records. For a selected capability, read its contract with a targeted `alexandria_library_search` command such as `cat /library/<category>/<provider>/<capability>.md`; build execution options from that contract. Do not invent a provider, capability, or field to make an example executable.
120
120
121
121
Example PDF read with `firecrawl_scrape`; choose `maxPages` for the evidence needed and any user limit:
0 commit comments