Skip to content

Mark research search-github deprecated: the endpoint stops responding after 2026-11-03 - #260

Closed
erikengervall wants to merge 2 commits into
mainfrom
deprecate-research-search-github
Closed

erikengervall wants to merge 2 commits into
mainfrom
deprecate-research-search-github

Conversation

@erikengervall

@erikengervall erikengervall commented Sep 19, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

GET /v2/search/research/github is deprecated in the API (apps/api/src/lib/deprecations.ts, v2_research_github_search: "stops responding after 2026-11-03", replacement /v2/search/developer). The hosted MCP server hid its firecrawl_research_search_github tool on 2026-09-03 (firecrawl-mcp-server #395); this CLI still advertised research search-github with no notice. A customer ticket (#40736) followed the MCP change the same day, and the Claude connector listing is being corrected in parallel.

What changes

  • src/index.ts: the command's help text starts with [Deprecated: use \firecrawl developer`; the endpoint stops responding after 2026-11-03]`, the pattern the browser command uses.
  • src/commands/research.ts: the handler prints one deprecation line to stderr on every run, naming firecrawl developer <query> and the docs page. stdout is unchanged, so scripts keep working until the sunset.
  • README.md: the example comment and the subcommand table say the same.

No behaviour change otherwise; the command still calls the endpoint.

Verification

  • pnpm build (tsc): clean
  • pnpm test: 34 files, 571 tests passed
  • node dist/index.js research --help shows the new description

Context

Decided under the Asana task "Fix the Claude connector listing to the six tools the server serves, and tell Anthropic" (step 4). The npm firecrawl-mcp package needs no code change: main already hides the tool on every profile and answers cached callers with DEPRECATED_TOOL; publishing 3.24.1 carries that to stdio users (3.24.0 on npm predates it).

🤖 Generated with Claude Code


Summary by cubic

Marks research search-github as deprecated because its endpoint stops responding after 2026-11-03, and points users to firecrawl developer. The command keeps working until then; its own help text, the parent research --help text, the README, and a stderr warning on every run all name the deprecation and replacement, and stdout is unchanged so scripts stay unaffected.

Written for commit c60653e. Summary will update on new commits.

Review in cubic

…ng 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 <noreply@anthropic.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 3 files

Shadow auto-approve: would not auto-approve because issues were found.

Fix all with cubic | Re-trigger cubic

Comment thread src/index.ts
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 <noreply@anthropic.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0 issues found across 1 file (changes from recent commits).

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Shadow auto-approve: would auto-approve. Adds deprecation notices for research search-github in help text, README, and per-run stderr while leaving stdout and endpoint calls unchanged. The deprecation originates upstream in the API and MCP server, so this is a bounded messaging change with no rollout or operational tradeoff.

Re-trigger cubic

@erikengervall
erikengervall deleted the deprecate-research-search-github branch September 19, 2026 05:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant