@wundercorp/guardian

Official JavaScript and TypeScript SDK for Guardian Search by WunderCorp.

Use Guardian API keys only from trusted server-side or agent runtimes. Do not embed a gdn_live_... key in public browser JavaScript or a shipped client bundle.

Install

npm install @wundercorp/guardian

Search

import Guardian from "@wundercorp/guardian";

const guardian = new Guardian({
  apiKey: process.env.GUARDIAN_API_KEY!
});

const response = await guardian.search({
  query: "best SOC 2 note-taking apps",
  vertical: "all",
  count: 10,
  region: "US"
});

for (const result of response.results) {
  console.log(result.rank, result.title, result.url);
}

Convenience methods are available for searchWeb, searchNews, searchImages, searchVideos, searchShopping, searchTravel, and searchDiscussions.

Finance

const quote = await guardian.financeQuote("AAPL");
console.log(quote.data);

MCP configuration

console.log(JSON.stringify(guardian.mcpConfig(), null, 2));

The generated configuration sends the same Guardian API key in the MCP Authorization header.

Errors

import Guardian, { GuardianError } from "@wundercorp/guardian";

try {
  await guardian.searchWeb("search query");
} catch (error) {
  if (error instanceof GuardianError) {
    console.error(error.status, error.code, error.requestId);
  }
}

Environment

Use GUARDIAN_API_KEY for your own applications. Do not expose a secret Guardian API key in client-side browser code.

The default API base URL is https://api.guardianbrowser.sh. Self-hosted or staging deployments can pass baseUrl to the constructor.