A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
TypeScript agent-skillsaidsh-pluginhacktoberfestjavascriptmcp-serverreactresume-builderself-hostedtypescript
import type { ProviderRequest } from "./contracts";
import z from "zod";
import { MAX_CONTENT_CHARS, MAX_PAGE_BYTES, WebAccessError } from "./contracts";
import { normalizeSearch, parseResponse, postJson } from "./transport";
const searchSchema = z.object({ results: z.array(z.unknown()).max(100) });
export async function searchExa(query: string, { connection, signal, region }: ProviderRequest) {
const response = parseResponse(
searchSchema,
await postJson(
"https://api.exa.ai/search",
{
"x-api-key": connection.apiKey ?? "",
},
{
query,
numResults: 5,
type: "auto",
// Two-letter ISO 3166-1 code: https://exa.ai/docs/reference/search (userLocation).
// Measured 2026-10-21: with "auto" it only nudges results, but it is the location signal Exa takes.
...(region ? { userLocation: region } : {}),
},
signal,
),
);
// Search has no text/highlights/summary request; fetch only the result the user selects.
return normalizeSearch(response.results);
}
const contentsSchema = z.object({
results: z
.array(
z.object({
url: z.string(),
text: z.string().max(MAX_PAGE_BYTES).optional(),
crawlDate: z.iso.datetime({ offset: true }).optional(),
}),
)
.max(100),
statuses: z.array(z.object({ id: z.string(), status: z.string() })).optional(),
});
export async function readExa(url: string, { connection, signal }: ProviderRequest) {
const response = parseResponse(
contentsSchema,
await postJson(
"https://api.exa.ai/contents",
{
"x-api-key": connection.apiKey ?? "",
},
{
urls: [url],
text: { maxCharacters: MAX_CONTENT_CHARS + 1 },
maxAgeHours: 0,
livecrawlTimeout: 14_000,
},
signal,
),
);
if (response.statuses?.some((status) => status.status !== "success")) {
throw new WebAccessError("unreachable");
}
const result = response.results[0];
if (!result?.text) throw new WebAccessError("empty");
return {
content: result.text,
format: "text" as const,
resolvedUrl: result.url,
...(result.crawlDate ? { providerFetchedAt: result.crawlDate } : {}),
};
}