maviapi

io.github.kuzenlabs由 GitHub 账号 kuzenlabs 发布v0.1.1更新于 Nov 8, 2026

Live JSON from sites with no API (Booking, Airbnb, Tripadvisor…), plus agent-built APIs for any site

概览

AI 生成的概览

让助手从没有 API 的网站(如 Booking、Airbnb、Tripadvisor)获取实时结构化 JSON,并可为其他网站申请新建 API。

可以做什么
  • 按网站或主题搜索 API 目录,或列出全部条目
  • 查看某个 API 的端点、参数和返回字段
  • 调用端点并取回实时 JSON 结果
  • 用网址和自然语言描述申请为新网站构建 API,并跟踪构建状态直至发布或失败
适用场景
当助手需要从没有官方 API 的旅行、预订、新闻、词典或行情网站获取结构化数据时适用;所需网站不在目录中时,也可申请为其构建 API。
运行要求
通过 npx 从 npm 包 @maviapi/mcp 以 stdio 在本地运行,需要 Node.js。不填密钥时使用共享演示密钥;个人密钥通过环境变量 MAVIAPI_API_KEY 提供。可选 MAVIAPI_TOOLS 用于暴露按端点生成的类型化工具,MAVIAPI_BASE_URL 可指向其他部署。需要能访问 maviapi 服务的网络。
安装前请注意
每次成功调用会消耗 maviapi 账户中的额度(失败调用免费),试用期后需付费,可能产生费用。可选的 MAVIAPI_API_KEY 是密钥,不要写入共享配置。create_api 会在第三方服务上启动构建,查询内容和所需数据会发送到 maviapi 的服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 maviapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

maviapi MCP server

Give Claude, Cursor, or any MCP client live, structured JSON from websites that have no API: Booking.com, Airbnb, Tripadvisor, Kiwi.com, Trainline, Hepsiburada, Yemeksepeti and more, plus any site you ask for.

You:    Find me a 3-night Airbnb in Lisbon next month under €120 a night.Claude: → search_apis "airbnb" → get_api "airbnb" → call_api airbnb/search {location: "Lisbon", …}        Here are the 5 best-rated options under €120…

Agents are bad at the web. Browsing is slow, burns tokens on raw HTML, and stalls on bot protection; hand-written scrapers break the next time the site changes its layout. maviapi turns a website into a hosted, schema-first JSON API, and monitors and repairs it when the site changes, so the endpoint your agent depends on keeps answering. This server puts those APIs one tool call away.

Works with no setup. Out of the box it uses maviapi's shared demo key: 30 requests a minute and 300 a day per network, plus 3 free API builds per 30 days. Create a free key for more.

Missing a site? Your agent can have it built. create_api hands maviapi's build agent a URL and a description of the data you want; about half an hour later the new API is live and callable from the same session.

Install

Claude Code

bash
claude mcp add maviapi -- npx -y @maviapi/mcp
# with your own keyclaude mcp add maviapi -e MAVIAPI_API_KEY=mvk_live_... -- npx -y @maviapi/mcp

Claude Desktop, Cursor, Windsurf, and others

Add this to the client's MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, …):

json
{  "mcpServers": {    "maviapi": {      "command": "npx",      "args": ["-y", "@maviapi/mcp"],      "env": { "MAVIAPI_API_KEY": "mvk_live_..." }    }  }}

Leave out env to try it with the demo key.

VS Code

.vscode/mcp.json:

json
{  "inputs": [{ "type": "promptString", "id": "maviapi-key", "description": "maviapi API key", "password": true }],  "servers": {    "maviapi": {      "command": "npx",      "args": ["-y", "@maviapi/mcp"],      "env": { "MAVIAPI_API_KEY": "${input:maviapi-key}" }    }  }}

Tools

ToolWhat it does
search_apisFind an API for a website or topic ("flights", "turkish news", "booking.com"). Empty query lists the whole catalog.
get_apiAn API's endpoints, their parameters, and the fields each one returns.
call_apiCall an endpoint and get live JSON back. List endpoints return 10 results unless you pass limit.
create_apiNo API for the site you need? Starts a build from a URL and a plain-language description, and returns a request_id.
get_build_statusFollows a build to published (then get_api and call_api work on it) or failed. Builds take about half an hour.

A handful of generic tools keeps the agent's context small however large the catalog grows. If you rely on a few APIs, MAVIAPI_TOOLS also exposes each of their endpoints as its own typed tool, with a full input schema:

bash
claude mcp add maviapi -e MAVIAPI_TOOLS=booking,airbnb,kiwi -- npx -y @maviapi/mcp# adds booking_search, booking_explore, airbnb_listing_by_id, kiwi_search, …

What you can ask

  • "Cheapest flights from Istanbul to Berlin any day in the first week of December?" (Kiwi.com, FlightList)
  • "Train or plane from London to Paris on Friday: which is cheaper?" (Trainline, Kiwi.com)
  • "Top-rated restaurants in Istanbul on Tripadvisor, with review counts."
  • "Bu hafta sonu İstanbul'da hangi konserler var?" (Bubilet)
  • "What are gold and silver trading at right now?" (Selcoin)
  • "What does 'serendipity' mean in Turkish? Give me every sense." (Sesli Sözlük)

search_apis with no query lists everything currently in the catalog. And for a site that is not there yet:

  • "Build me an API for news.ycombinator.com with the front page stories, points and comment counts, then show me today's top 5."

Configuration

VariableDefaultPurpose
MAVIAPI_API_KEYshared demo keyYour key from the maviapi dashboard.
MAVIAPI_TOOLSnoneComma-separated API slugs to expose as typed per-endpoint tools, or all.
MAVIAPI_BASE_URLhttps://api.maviapi.comPoint at another maviapi deployment.

Pricing

Each successful call uses one credit; failed calls are free. Building an API is free on any plan, within the daily build limit (10 a day per account with your own key). New accounts start with a 7-day trial of 5,000 credits, no card required. Plans are on maviapi.com/pricing.

Development

bash
pnpm installpnpm test          # unit and protocol tests, offlinepnpm buildpnpm test:live     # smoke test of the built server against the real APIpnpm inspect       # open the MCP Inspector against the built server

License

MIT

来源:README.md,提交 b6be662

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Nov 8, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分