OpenCode

Native web tools inside OpenCode

opencode-search1api is a native OpenCode plugin. It registers search, news, page reading, sitemap discovery, and trending as first-class tools, for this project or globally.

What the plugin adds

Five tools, no MCP config

`search1api_search`, `search1api_news`, `search1api_crawl`, `search1api_sitemap`, and `search1api_trending` are native OpenCode tools.

Project or global

`opencode plugin opencode-search1api` installs for the current project. Add `--global` to install once for every project.

Three ways to authenticate

Set `SEARCH1API_KEY` in the OpenCode environment, reuse an `s1 login` session, or pass `apiKey` in `opencode.json`.

Add the plugin

Install for this project or globally. Prefer an environment variable over committing a key. The JSON block is only needed when you want the key in `opencode.json`.

Install — bash
opencode plugin opencode-search1api
# or, for every project:
opencode plugin opencode-search1api --global

opencode.json (optional) — json
{
  "plugin": [
    ["opencode-search1api", { "apiKey": "your-api-key" }]
  ]
}

Worth knowing

Prefer `SEARCH1API_KEY` or a secret manager over putting a key in `opencode.json`, which is often committed.

This is not an MCP client config. OpenCode calls Search1API through the plugin.

Tool calls bill as ordinary API calls: 1 credit per search or news request, plus 1 for each page successfully retrieved.

What people do with it

Let OpenCode check current library docs before it writes an import.

Read a changelog URL in the same session.

Check GitHub or Hacker News trends when starting a task.

FAQ

How is this different from the MCP server?

The MCP server is a hosted process a client talks to over HTTP. This plugin runs inside OpenCode and registers native tools, so there is no MCP transport to configure.

Do I still need an API key?

Usually yes — set `SEARCH1API_KEY` where OpenCode runs. If `search1api-cli` is installed and you have already run `s1 login`, the plugin reuses that OAuth session instead.

How much does it cost?

New accounts get 100 credits free with no card. A search or news request is 1 credit, and each page successfully retrieved adds 1 more.