open-index/open-npm huggingface dataset:
npm package: @saintedlama/openclaw-serpapi
Description: OpenClaw plugin for web search via SerpAPI
Latest version: 1.1.0

# openclaw-plugin-serpapi

OpenClaw plugin that gives your agent web search via [SerpAPI](https://serpapi.com). Registers the `serpapi_web_search` tool, which queries Google and returns organic results.

## 5-minute install

**1. Get a SerpAPI key**

Sign up at [serpapi.com/manage-api-key](https://serpapi.com/manage-api-key) and copy your API key.

**2. Install the plugin**

```sh
openclaw plugins install @saintedlama/openclaw-serpapi
```

**3. Add your API key to the OpenClaw config**

```json
{
  "plugins": {
    "entries": {
      "serpapi": {
        "config": {
          "apiKey": "your-serpapi-key-here"
        }
      }
    }
  }
}
```

Alternatively, set the `SERPAPI-WEB-SEARCH-KEY` environment variable instead of putting the key in config.

**4. Restart the Gateway**

```sh
openclaw restart
```

The agent now has access to the `serpapi_web_search` tool.

## Configuration

| Field         | Type   | Default | Description                                      |
| ------------- | ------ | ------- | ------------------------------------------------ |
| `apiKey`      | string | —       | SerpAPI key (or set `SERPAPI-WEB-SEARCH-KEY` env) |
| `resultCount` | number | `10`    | Default number of organic results (1–100)        |

## Tool parameters

The `serpapi_web_search` tool accepts:

| Parameter       | Required | Description                                      |
| --------------- | -------- | ------------------------------------------------ |
| `query`         | yes      | Search query                                     |
| `num`           | no       | Number of results (1–100, overrides config default) |
| `gl`            | no       | Country code, e.g. `"us"`, `"gb"` (default: `"us"`) |
| `hl`            | no       | Language code, e.g. `"en"`, `"de"` (default: `"en"`) |
| `location`      | no       | Location string (default: `"United States"`)     |
| `google_domain` | no       | Google domain (default: `"google.com"`)          |

## License

MIT
npm package: @sainthoodlabs/agentsaint-sdk
Description: Agent Saint API SDK
Author: Sainthood Labs
Latest version: 0.1.3

# Agent Saint SDK

Official TypeScript SDK for interacting with the Agent Saint API.

## Installation

```bash
npm install @sainthoodlabs/agentsaint-sdk
```

## Usage

```typescript
import { AgentSaintClient } from "@sainthoodlabs/agentsaint-sdk";

const client = new AgentSaintClient({
  apiKey: "your_api_key",
  userId: "your_user_id",
  baseUrl: "https://your-deployment-url.vercel.app", // Optional
});

// Send a message to a specific agent (creates a new session by default)
const responseMessage = await client.sendPrompt({
  agentId: "agent_id",
  prompt: "Hello, world!",
});

// Send a message to a specific session
const sessionResponse = await client.sendPrompt({
  agentId: "agent_id",
  sessionId: "session_id", // Optional - will create a new session if not provided
  prompt: "Continue our conversation",
});
```

## API Reference

### Configuration

The `AgentSaintClient` constructor accepts the following configuration options:

- `apiKey` (required): Your Agent Saint API key
- `userId` (required): Your Agent Saint user ID
- `baseUrl` (optional): The base URL for API requests. Defaults to 'https://agentsaint.com'

### Methods

#### sendPrompt

Sends a prompt to a conversation and returns the updated chat history.

```typescript
sendPrompt(params: {
  agentId: string;
  sessionId?: string; // Optional - specifies which session to use
  prompt: string;
}): Promise<string>
```

## License

MIT