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 分