Create a minimal working Exa example. Use when starting a new Exa integration, testing your setup, or learning basic Exa API patterns. Trigger with phrases like "exa hello world", "exa example", "exa quick start", "simple exa code".
npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill exa-hello-worldLoading…
Minimal working examples demonstrating all core Exa search operations: basic search, search with contents, find similar, and get contents. Each example is runnable standalone.
exa-js SDK installed (npm install exa-js)EXA_API_KEY environment variable setimport Exa from "exa-js";
const exa = new Exa(process.env.EXA_API_KEY);
// Basic search returns URLs, titles, and scores — no page content
const results = await exa.search("best practices for building RAG pipelines", {
type: "auto", // auto | neural | keyword | fast | instant
numResults: 5,
});
for (const r of results.results) {
console.log(`[${r.score.toFixed(2)}] ${r.title}`);
console.log(` ${r.url}`);
}
// searchAndContents returns text, highlights, and/or summary with each result
const results = await exa.searchAndContents(
"how transformers work in large language models",
{
type: "neural",
numResults: 3,
text: { maxCharacters: 1000 },
highlights: { maxCharacters: 500, query: "attention mechanism" },
summary: { query: "explain transformers simply" },
}
);
for (const r of results.results) {
console.log(`## ${r.title}`);
console.log(`URL: ${r.url}`);
console.log(`Summary: ${r.summary}`);
console.log(`Text preview: ${r.text?.substring(0, 200)}...`);
console.log(`Highlights: ${r.highlights?.join(" | ")}`);
console.log();
}
// findSimilar takes a URL and returns semantically similar pages
const similar = await exa.findSimilarAndContents(
"https://arxiv.org/abs/2301.00234",
{
numResults: 5,
text: { maxCharacters: 500 },
excludeSourceDomain: true,
}
);
console.log("Pages similar to the seed URL:");
for (const r of similar.results) {
console.log(` ${r.title} — ${r.url}`);
}
// getContents retrieves page content for specific URLs
const contents = await exa.getContents(
["https://example.com/article-1", "https://example.com/article-2"],
{
text: { maxCharacters: 2000 },
highlights: { maxCharacters: 500 },
livecrawl: "preferred",
livecrawlTimeout: 10000,
}
);
for (const r of contents.results) {
console.log(`${r.title}: ${r.text?.length} chars retrieved`);
}
| Error | HTTP Code | Cause | Solution |
|---|---|---|---|
INVALID_API_KEY | 401 | API key missing or invalid | Check EXA_API_KEY env var |
INVALID_REQUEST_BODY | 400 | Malformed parameters | Verify parameter types match SDK docs |
NO_MORE_CREDITS | 402 | Account credits depleted | Top up at dashboard.exa.ai |
429 Too Many Requests | 429 | Rate limit exceeded | Wait and retry; default is 10 QPS |
Empty results array | 200 | Query too narrow or filters too strict | Broaden query or relax date/domain filters |
import Exa from "exa-js";
const exa = new Exa(process.env.EXA_API_KEY);
async function main() {
// 1. Search
const search = await exa.search("AI safety research", { numResults: 3 });
console.log(`Found ${search.results.length} results\n`);
// 2. Search with contents
const detailed = await exa.searchAndContents("AI safety research", {
numResults: 2,
text: true,
highlights: { maxCharacters: 300 },
});
console.log("First result text length:", detailed.results[0]?.text?.length);
// 3. Find similar
if (search.results[0]) {
const similar = await exa.findSimilar(search.results[0].url, {
numResults: 3,
});
console.log("\nSimilar pages:", similar.results.map(r => r.title));
}
}
main().catch(console.error);
Proceed to exa-core-workflow-a for neural search patterns or exa-sdk-patterns for production-ready code.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).