{"id":50508513,"url":"https://github.com/firecrawl/firecrawl-codex-plugin","last_synced_at":"2026-06-02T18:01:30.012Z","repository":{"id":357137406,"uuid":"1235527872","full_name":"firecrawl/firecrawl-codex-plugin","owner":"firecrawl","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-11T13:02:57.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-11T14:39:29.380Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/firecrawl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T12:11:39.000Z","updated_at":"2026-05-11T13:03:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/firecrawl/firecrawl-codex-plugin","commit_stats":null,"previous_names":["firecrawl/firecrawl-codex-plugin"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/firecrawl/firecrawl-codex-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firecrawl%2Ffirecrawl-codex-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firecrawl%2Ffirecrawl-codex-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firecrawl%2Ffirecrawl-codex-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firecrawl%2Ffirecrawl-codex-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firecrawl","download_url":"https://codeload.github.com/firecrawl/firecrawl-codex-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firecrawl%2Ffirecrawl-codex-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33833277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-02T18:01:29.340Z","updated_at":"2026-06-02T18:01:29.985Z","avatar_url":"https://github.com/firecrawl.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Firecrawl Codex plugin\n\nOpenAI [Codex plugin](https://developers.openai.com/codex/plugins/build) that bundles Firecrawl **CLI workflow skills** (search, scrape, crawl, map, interact, agent, parse, download) and the **Firecrawl MCP server** for tool-style access.\n\nCanonical skill sources live in [`firecrawl/cli`](https://github.com/firecrawl/cli) (`cli/skills/`). This repo vendors copies for the Codex plugin distribution; refresh when CLI skills change materially.\n\n## Requirements\n\n- [Node.js](https://nodejs.org/) 18+ (for `npx firecrawl-mcp` when using bundled MCP).\n- [Firecrawl CLI](https://www.npmjs.com/package/firecrawl-cli) installed and authenticated for skill workflows that shell out to `firecrawl`:\n\n  ```bash\n  npm install -g firecrawl-cli\n  firecrawl login --browser\n  ```\n\n  Or set `FIRECRAWL_API_KEY` in your environment.\n\n## Install in Codex (local marketplace)\n\nUntil the plugin is listed in the official Codex Plugin Directory, wire a **repo** or **personal** marketplace as described in the OpenAI docs.\n\n### Option A: Git clone next to your project\n\n1. Clone this repository (for example into `plugins/firecrawl-codex-plugin` at the root of the repo where you use Codex).\n\n2. Add `.agents/plugins/marketplace.json` at that repo root (see [`examples/marketplace.json`](examples/marketplace.json)). Point `source.path` at the plugin folder with a `./`-prefixed path relative to the marketplace file’s directory.\n\n3. Set MCP credentials in `~/.codex/config.toml` so the bundled server can authenticate (do **not** commit secrets):\n\n   ```toml\n   [mcp_servers.firecrawl.env]\n   FIRECRAWL_API_KEY = \"fc-YOUR-API-KEY\"\n   ```\n\n   Alternatively use a [remote MCP URL](https://docs.firecrawl.dev/quickstarts/codex-cli) and disable or omit the bundled MCP entry in your Codex config if you prefer.\n\n4. Restart Codex. Open **Plugins** (Codex app) or run `/plugins` in Codex CLI, pick your marketplace, install **Firecrawl**, enable the plugin.\n\n### Option B: Codex CLI marketplace add\n\nFrom the OpenAI docs:\n\n```bash\ncodex plugin marketplace add ./path-to-marketplace-root\n```\n\nUse a marketplace JSON that references this plugin directory (same shape as `examples/marketplace.json`).\n\n## Bundled MCP\n\n[`.mcp.json`](.mcp.json) runs `npx -y firecrawl-mcp`. You must provide `FIRECRAWL_API_KEY` via Codex MCP server environment configuration.\n\n## Smoke checks (after install)\n\nIn a new Codex thread, try:\n\n1. “Search the web for the latest Firecrawl changelog and summarize.”\n2. “Scrape https://docs.firecrawl.dev and list top-level sections.”\n3. “Use Firecrawl MCP to call `firecrawl_scrape` on https://example.com.” (if MCP is enabled)\n\nCLI-only checks from a terminal:\n\n```bash\nfirecrawl --status\nfirecrawl search \"firecrawl web scraping\" --limit 3 --json\n```\n\nThe `_local/` directory is gitignored; use it in your clone for any markdown or notes you do not want committed.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirecrawl%2Ffirecrawl-codex-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirecrawl%2Ffirecrawl-codex-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirecrawl%2Ffirecrawl-codex-plugin/lists"}