Skip to content

Docs: rewrite the README to match the Claude plugin#1

Closed
rakshith48 wants to merge 2 commits into
mainfrom
docs/readme-refresh
Closed

Docs: rewrite the README to match the Claude plugin#1
rakshith48 wants to merge 2 commits into
mainfrom
docs/readme-refresh

Conversation

@rakshith48

@rakshith48 rakshith48 commented Jun 9, 2026

Copy link
Copy Markdown
Owner

Brings the Cursor plugin README up to parity with the Claude plugin and fixes factual errors.

Fixes

  • Stale link: github.com/mendableai/firecrawl-clifirecrawl/cli
  • "What's included" was wrong — claimed a single skills/firecrawl/SKILL.md; the repo actually ships 10 skills
  • Install instructions corrected — uses the supported path today: npx -y firecrawl-cli@latest init --all --browser (installs skills into .cursor/skills and signs in via browser). Earlier I'd written /add-plugin, but Cursor's in-editor plugin install / Marketplace isn't available to users yet.
  • Adds Usage examples, full Capabilities (incl. interact, monitor, parse, download), Command-reference link, Configuration table, Resources, and Support
  • License set to MIT (matches plugin.json)

⚠️ No LICENSE file exists in the repo though the manifest says MIT — worth adding one.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Rewrote README with a guided install flow and CLI-based authentication options
    • Added a note to restart the app after installation
    • Expanded capabilities list (Interact, Monitor, Parse, Download) and updated usage examples
    • Added configuration table for relevant environment variables and self-hosted guidance
    • Pointed "What's included" to available assets and added a command reference; consolidated Resources, License, and Support sections

- Fix stale org links (mendableai/* -> firecrawl/*)
- Replace the partial/drifting CLI command table with a link to the
  canonical docs (docs.firecrawl.dev/cli)
- List the actual shipped capabilities/skills (adds interact, agent,
  monitor, parse, download — previously missing or inaccurate)
- Clarify install: add plugin -> install CLI -> sign in (browser, with
  API-key/env alternatives)
- Add a Configuration table (incl. FIRECRAWL_NO_TELEMETRY opt-out) and
  tidy Resources/Support
- Set license to MIT for consistency with the manifest and sibling plugins

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 9, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: bfe18593-46e3-4512-b32c-a6f43ae5cce5

📥 Commits

Reviewing files that changed from the base of the PR and between 26cc4d9 and 3fafa74.

📒 Files selected for processing (1)
  • README.md
✅ Files skipped from review due to trivial changes (1)
  • README.md

📝 Walkthrough

Walkthrough

The README is completely rewritten to establish Firecrawl for Cursor as a CLI-driven plugin providing web scraping with anti-bot handling. Installation now spans Cursor plugin setup, global CLI installation, and authentication. Capabilities expand with new features and usage examples demonstrate real workflows. Configuration tables and self-hosting guidance round out the documentation.

Changes

README Documentation Update

Layer / File(s) Summary
Title and Overview
README.md
Plugin title changed to "Firecrawl for Cursor" with revised description emphasizing web-to-LLM-ready markdown/structured data access through Firecrawl CLI with rendering, anti-bot, and proxy capabilities.
Installation and Authentication
README.md
New Install section walks through three steps: adding plugin in Cursor via npx firecrawl-cli@latest init --all --browser, global installation of firecrawl-cli, and authentication choices (browser login or API key with environment variable setup); notes restart requirement.
Capabilities and Usage Examples
README.md
Expanded Capabilities list now includes Interact, Monitor, Parse, and Download alongside existing scraping features. Usage section provides concrete example prompts demonstrating search, scrape, map, and monitor workflows; references skills/ and rules/install.mdc, and points to Firecrawl CLI docs.
Configuration and Implementation Details
README.md
Configuration table documents FIRECRAWL_API_KEY, FIRECRAWL_API_URL, and FIRECRAWL_NO_TELEMETRY. Self-hosting note explains custom FIRECRAWL_API_URL behavior and how it affects API-key auth.
Resources, License, and Support
README.md
Resources consolidated, License unchanged (MIT), and Support section updated with Discord, GitHub Issues, and contact email links.

🎯 2 (Simple) | ⏱️ ~8 minutes

A rabbit's tale of words rearranged,
From plugin to CLI, oh how docs have changed!
With setup so clear and examples so bright,
Firecrawl for Cursor now shines in full light. 🐰✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Docs: rewrite the README to match the Claude plugin' directly reflects the main change: rewriting the README documentation to align with the Claude plugin. It is concise, clear, and accurately summarizes the primary objective of the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/readme-refresh

Comment @coderabbitai help to get the list of available commands and usage tips.

/add-plugin and the Cursor plugin Marketplace aren't available to users
yet. The supported install today is the Firecrawl CLI's init, which
installs the skills into Cursor (.cursor/skills) and authenticates:
  npx -y firecrawl-cli@latest init --all --browser

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 55-60: The fenced code block containing the usage/demo lines is
missing a language tag causing MD040; update that fenced block (the
triple-backtick block that contains the four sample tasks like "Search for 'best
practices for React testing'..." and the other three lines) by adding a language
identifier (e.g., text) immediately after the opening ``` so it becomes ```text
to ensure proper linting and rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a247649f-6368-457d-b287-acf0a9314103

📥 Commits

Reviewing files that changed from the base of the PR and between d2c5386 and 26cc4d9.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
@rakshith48

Copy link
Copy Markdown
Owner Author

Migrated to the upstream repo: firecrawl#30

@rakshith48 rakshith48 closed this Jun 9, 2026
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