feat: add Exa AI-powered search tool#266
Open
tgonzalezc5 wants to merge 1 commit intocoreyhaines31:mainfrom
Open
feat: add Exa AI-powered search tool#266tgonzalezc5 wants to merge 1 commit intocoreyhaines31:mainfrom
tgonzalezc5 wants to merge 1 commit intocoreyhaines31:mainfrom
Conversation
Adds Exa as an AI search integration for content research, competitor discovery, link prospecting, news monitoring, and audience research. - CLI (tools/clis/exa.js): zero-dep Node.js wrapper for /search, /findSimilar, and /contents with neural/auto/fast/deep search types, category + domain + text + date filtering, and composable content retrieval (text, highlights, summary) in a single request - Integration guide (tools/integrations/exa.md): auth, endpoints, common agent operations, parameters, and linked skills - Registry entry under new 'AI Search' category + MCP-enabled list - Uses EXA_API_KEY env var with --dry-run support and masked credentials
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
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.
Summary
Adds Exa — an AI-powered web search API built for LLMs and agents — as a new tool integration. Exa returns high-quality results via neural/semantic or keyword-like search, with on-demand content retrieval (full text, highlights, summaries) in a single request. It's a strong fit for content research, competitor discovery, link prospecting, news monitoring, and audience research workflows that marketing agents run.
What's added
tools/clis/exa.js) — zero-dependency Node.js wrapper matching the existing CLI pattern (nativefetch, env-var auth, JSON output,--dry-runwith masked credentials). Supports:search—/searchwithtype(neural / fast / auto / deep-lite / deep / deep-reasoning / instant),category, domain + text filters, published/crawl date ranges,userLocation, and composablecontents(text/highlights/summary can be requested together)find-similar—/findSimilarto discover pages similar to a given URLcontents—/contentsto fetch text/highlights/summary for one or more known URLstools/integrations/exa.md) — auth, endpoints, common agent operations (competitor content discovery, find-similar, category-filtered news search, contents fetch), parameter reference, and linked skillstools/REGISTRY.md) — new "AI Search" category + MCP-enabled list entrytools/clis/README.md) — addsEXA_API_KEYenv var and CLI listingUsage
Files changed
tools/clis/exa.js(new) — 130-line CLI wrappertools/integrations/exa.md(new) — integration guidetools/REGISTRY.md— adds Exa row, new "AI Search" category section, MCP-enabled entrytools/clis/README.md— env var + CLI listingTest plan
node --check tools/clis/exa.js)searchbuilds correct/searchbody with filters, categories, and mixedcontentsfields (text + highlights + summary together) — verified via--dry-runfind-similarbuilds correct/findSimilarbodycontentsplaces text/highlights/summary at top level alongsideurls(matches Exa API schema)EXA_API_KEYexits with JSON error--query,--url,--urls) returns structured JSON error--dry-runmasks the API key as***(matches PR fix: harden CLI tools against credential leakage #253 credential-hardening pattern)x-exa-integration: marketingskillstracking header is sent on every request