From be752701ae33cab068e0082d79cedf75e33a6ff8 Mon Sep 17 00:00:00 2001 From: Erik Engervall Date: Sat, 19 Sep 2026 12:57:37 +0900 Subject: [PATCH 1/2] Mark `research search-github` deprecated: the endpoint stops responding after 2026-11-03 GET /v2/search/research/github is deprecated in the API (apps/api/src/lib/deprecations.ts, v2_research_github_search, sunset Tue, 03 Nov 2026) and replaced by the developer index, which this CLI already exposes as `firecrawl developer`. The hosted MCP server hid its firecrawl_research_search_github tool on 2026-09-03; this CLI still advertised the command with no notice. The command keeps working until the sunset. Its help text and the README table say it is deprecated and name the replacement, and the handler prints one line to stderr on every run (stdout stays the result, so scripts are unaffected). The pattern is the one the browser command already uses. Verified: pnpm build (tsc) clean, pnpm test 34 files, 571 tests passed. Co-Authored-By: Claude Fable 5.1 --- README.md | 4 ++-- src/commands/research.ts | 5 +++++ src/index.ts | 5 ++++- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index efcc3c8e7e..01d6c3deee 100644 --- a/README.md +++ b/README.md @@ -448,7 +448,7 @@ firecrawl research related-papers pmcid:PMC12530322 --intent "in vivo delivery" # Read full-text passages to verify a specific claim firecrawl research read-paper doi:10.1016/j.neunet.2025.108095 --question "What was the sample size?" -# Search GitHub issue/PR history and repository READMEs +# Deprecated (stops working after 2026-11-03): use `firecrawl developer` instead firecrawl research search-github "foundationdb queue worker shutdown" --limit 10 ``` @@ -462,7 +462,7 @@ Paper ids accept `pmid:`, `pmcid:`, `doi:`, and `arxiv:` forms, plus canonical ` | `inspect-paper ` | Canonical metadata: title, abstract, authors, categories, source ids, dates | | `related-papers ` | Citation-graph expansion from seed papers, ranked against `--intent` | | `read-paper ` | Best-matching in-body full-text passages for a `--question` | -| `search-github ` | GitHub issue/PR history and repository READMEs | +| `search-github ` | Deprecated, stops working after 2026-11-03: use `firecrawl developer` | #### `search-papers` Options diff --git a/src/commands/research.ts b/src/commands/research.ts index 45a03ddc4b..fb6847f5d2 100644 --- a/src/commands/research.ts +++ b/src/commands/research.ts @@ -292,6 +292,11 @@ export async function handleReadPaperCommand( export async function handleSearchGitHubCommand( options: SearchGitHubOptions ): Promise { + // The endpoint behind this command is deprecated and stops responding after + // 2026-11-03; say so on stderr so scripts keep their stdout and humans see it. + console.error( + 'firecrawl research search-github is deprecated and stops working after 2026-11-03. Use `firecrawl developer ` (GitHub issues, PRs, READMEs and curated docs): https://docs.firecrawl.dev/features/developer' + ); try { const params = new URLSearchParams(); appendParam(params, 'query', options.query); diff --git a/src/index.ts b/src/index.ts index 393197ddce..57a9891c41 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1349,10 +1349,13 @@ Examples: }); }); + // Deprecated: GET /v2/search/research/github stops responding after 2026-11-03 + // (the API's deprecations table); `firecrawl developer` is the replacement, on + // the developer index. The command keeps working until the sunset and says so. researchCmd .command('search-github') .description( - 'Search GitHub issue/PR history and repository readmes. Returns ranked matches with repo, url, a short snippet, and when available the full matched content in markdown.' + '[Deprecated: use `firecrawl developer`; the endpoint stops responding after 2026-11-03] Search GitHub issue/PR history and repository readmes. Returns ranked matches with repo, url, a short snippet, and when available the full matched content in markdown.' ) .argument('', 'GitHub history/readme search query') .option( From c60653ed243c10d5e23db3c2b6bd738108837234 Mon Sep 17 00:00:00 2001 From: Erik Engervall Date: Sat, 19 Sep 2026 13:16:39 +0900 Subject: [PATCH 2/2] The parent research help carries the deprecation too Review on #260: `firecrawl research --help` still said "Also searches GitHub issue/PR history" and listed the search-github example as a normal one. The parent description now says the GitHub search moved to `firecrawl developer` and that search-github is deprecated with the 2026-11-03 sunset, and the example block shows the developer command with the deprecation in a trailing note. Build and the 571 tests unchanged. Co-Authored-By: Claude Fable 5.1 --- src/index.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/index.ts b/src/index.ts index 57a9891c41..d318ec17f6 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1152,7 +1152,7 @@ Examples: function createResearchCommand(): Command { const researchCmd = new Command('research') .description( - "Search Firecrawl's research paper index: ~43M abstracts, around 90% biomedical (PubMed, bioRxiv, medRxiv) plus arXiv. Use this for biomedical, clinical, and scientific literature instead of scraping PubMed, bioRxiv, or Google Scholar by hand. Also searches GitHub issue/PR history." + "Search Firecrawl's research paper index: ~43M abstracts, around 90% biomedical (PubMed, bioRxiv, medRxiv) plus arXiv. Use this for biomedical, clinical, and scientific literature instead of scraping PubMed, bioRxiv, or Google Scholar by hand. GitHub issue/PR history moved to `firecrawl developer`; `research search-github` is deprecated and stops working after 2026-11-03." ) .addHelpText( 'after', @@ -1164,7 +1164,7 @@ Examples: $ firecrawl research related-papers pmcid:PMC12530322 --intent "in vivo delivery" $ firecrawl research read-paper doi:10.1016/j.neunet.2025.108095 --question "What was the sample size?" $ firecrawl research read-paper arxiv:1706.03762 --question "What is the attention mechanism?" - $ firecrawl research search-github "foundationdb queue worker shutdown" --limit 10 + $ firecrawl developer "foundationdb queue worker shutdown" --limit 10 (search-github is deprecated: stops working after 2026-11-03) ` );