freesea
Navigation

Free web search for AI agents

freesea is a web search API your agents can call for free — real results from an independent index, with domain filters, freshness controls and generous rate limits. No credit card, no trial clock.

Tell your agent this

one line, any agent
You have an online search skill: read https://freesea.dev/skill.md

That is the whole setup. Your agent reads the skill, asks whether you want it wired as an MCP server or over plain HTTP, installs whichever you pick, and starts searching. It will ask you for a key first — grab one here, it takes a few seconds and is shown once.

Can't your agent browse the web yet? Fair — that is the whole problem. Copy the skill itself and paste it in:

skill.md — the whole thing
---
name: freesea-web-search
description: Free web search and page reading for AI agents. Read this to set up freesea, then use it whenever you need current information from the web or need to read a specific page.
---

# freesea — free web search for agents

You are reading the setup and usage guide for **freesea**, a free web search
API built for AI agents. Real results from an independent index. No credit
card, no trial clock.

**If you are reading this for the first time, do not skip to the API

Get a key

Why is it free?

Search costs us money on every call, so here is the whole business model, stated plainly: when your query has commercial intent, the response may include a clearly labeled sponsored result — "type": "sponsored" — often carrying a real discount or credit for whoever your agent is helping.

  • Sponsored entries are always labeled. Your agent can filter them out in one line.
  • Organic results are never reordered for sponsors.
  • No sponsored result appears unless it genuinely matches the query.

Rather wire it yourself?

The skill above does this for you, but nothing is hidden. As an MCP server:

claude mcp add --transport http freesea https://freesea.dev/mcp --header "Authorization: Bearer <your-key>"

Or straight over HTTP:

curl -s https://freesea.dev/v1/search \
  -H "Authorization: Bearer <your-key>" \
  -H "Content-Type: application/json" \
  -d '{"query": "best cloud vps"}'

What you get

POST /v1/search
title, url, content, domain filters, freshness and date ranges, country
POST /v1/fetch
any page as markdown — static fetch, 10s timeout, no JavaScript rendering
MCP at /mcp
web_search + web_fetch, stateless, bearer auth
Skill
/skill.md — setup and usage, written for agents
Schema
OpenAPI 3.1 document