@SERPHouse/ai-sdk

AI tool calling utilities for web search, news, and short videos — powered by SERPHouse.

Drop-in Vercel AI SDK tool() definitions for Google web search, news, and short-video search.

Install

npm install @serphouse/ai-sdk

Requires Node.js >= 18 with ai and zod as peer dependencies.

Quick Start

1. Get your API key from the SERPHouse Dashboard and set it:

export SERPHOUSE_API_KEY="your_key_here"

2. Import and use with any AI SDK model:

import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
import { search, news } from "@serphouse/ai-sdk";

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools: { search: search(), news: news() },
  prompt: "What are the latest AI news?",
});

The LLM decides when to call each tool. No manual API wiring needed.

Tools

| Tool | Description | API Endpoint | |------|-------------|--------------| | search(options?) | Google web search | /web-search-lite | | news(options?) | Google News search | /google-news | | shortVideo(options?) | Google Short Videos search | /google-short-videos-api |

Each returns a typed Vercel AI SDK tool object with a Zod input schema and execute handler.

Input Schema

| Field | Type | Default | Description | |-------|------|---------|-------------| | q | string | — | Search query (required) | | domain | string | "google.com" | Google domain | | lang | string | "en" | Language code | | loc | string | "New York,New York,United States" | Location (City,State,Country) | | page | number | — | Page number | | date_range | string | "y" | Time filter: h, d, w, m, y, or YYYY-MM-DD,YYYY-MM-DD | | device | "desktop" \| "mobile" | "desktop" | Device type | | gl | string | "US" | Country GL code — search only |

Authentication

The library resolves the API key in this order:

1. apiKey option passed to the tool factory
2. SERPHOUSE_API_KEY environment variable

// Env var (default)
const tool = search();

// Explicit key (overrides env)
const tool = search({ apiKey: "sk-..." });

API

search(options?)

import { search } from "serptool";
const tool = search();

Google web search — organic results, ads, related searches.

news(options?)

import { news } from "@serphouse/ai-sdk";
const tool = news();

Google News search — headlines, sources, publish dates.

shortVideo(options?)

import { shortVideo } from "@serphouse/ai-sdk";
const tool = shortVideo();

Google Short Videos search.

ToolOptions

type ToolOptions = { apiKey?: string };

Examples

Anthropic

import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
import { search } from "@serphouse/ai-sdk";

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-20250514"),
  tools: { search: search() },
  prompt: "Search for the latest tech news.",
});

Google Gemini

import { generateText } from "ai";
import { google } from "@ai-sdk/google";
import { search } from "@serphouse/ai-sdk";

const { text } = await generateText({
  model: google("gemini-2.0-flash"),
  tools: { search: search() },
  prompt: "Search for AI startups.",
});

License

MIT