feat(cli): add Alexandria discovery and Find Tools - #220
Draft
developersdigest wants to merge 9 commits into
Draft
feat(cli): add Alexandria discovery and Find Tools#220developersdigest wants to merge 9 commits into
developersdigest wants to merge 9 commits into
Conversation
…xchange command
Search accepts `--sources exchange` and passes `data.exchange[]` capability
hits through untouched (readable "=== Exchange Providers ===" section, JSON
keeps id/creditsUsed). New `firecrawl exchange discover [cohort] [provider]
[capability] [--query q] [--limit n] [--expand all]` walks or semantically
searches the catalogue via GET /exchange/discover, and `firecrawl exchange
retrieve <provider/capability>... --options '<json>'` executes capabilities
through the url-less POST /v2/scrape {exchange:[...], integration:'cli'}
shape, printing each item with its creditsCost and mirroring the API
envelope with --json. `firecrawl scrape --exchange provider/capability
--options '<json>'` delegates to the same executor. Exchange requests are
refused locally in keyless mode with an explanatory error (exit 1) and API
error bodies (403/402/409) are relayed instead of the axios status text.
Claude-Session: https://claude.ai/code/session_01KpbshKPNuCDBD4TLJ8T2UQ
Exchange capability addresses are provider-relative (e.g. series/observations for fred), not finance/series/observations. Fix README, help text, option descriptions, comments and test fixtures; no behaviour change. Claude-Session: https://claude.ai/code/session_01KpbshKPNuCDBD4TLJ8T2UQ
…accept Carry requiresAction through exchange retrieve and scrape failures, print a terms block in human mode and a failure envelope in --json mode, add `firecrawl alexandria terms <provider>` and `terms accept <provider>` (interactive only, posts to the dashboard accept route), register the group as `alexandria` with `exchange` as a hidden alias, and document the flow.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds Alexandria discovery and provider execution to the CLI:
search --sources alexandriareturns tool contracts,find-toolsexplores providers and capabilities, andscrape --exchangeexecutes a selected tool with a stable request ID. Semantic and contextual matches share thetoolsresult.Updates the bundled main, Search, and Scrape skills with the Alexandria workflow, unified
data.toolsresults, Find Tools pagination, and execution retry guidance. Detailed examples live in a shared skill reference.Includes the existing Exchange command groundwork and retains the proxy commands for the current deployment. The Alexandria workflow uses the canonical Search/Scrape endpoints and requires the billing API update plus the matching Exchange deployment before release.
CLI implementation validation: 112 focused command tests and the TypeScript build passed. Semantic discovery and free Find Tools calls passed against
firecrawl-local; paid execution was covered with mock HTTP tests. The local Cubic review had no remaining valid findings. The skill update passed frontmatter validation, Prettier, reference-link and shell-syntax checks, and the feedback guard checks; command flags and Particle inputs were verified against the implementation and a prior live response.Related previews: SDKs, MCP, and docs.