@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:

apiKey option passed to the tool factory
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

FilesExpand file tree

README.md

Latest commit

History