使用官方 Tavily 用戶端連接 BazaarLink

將已驗證的 Tavily 用戶端與整合指向 BazaarLink，只需更換 base URL 並使用 BazaarLink API 金鑰。本頁只列出已從原始碼驗證的行為。

Base URL 與驗證

建議使用 https://api.bazaarlink.ai/v1。既有的 https://bazaarlink.ai/api/v1 仍受支援。Python SDK 會傳送 Authorization: Bearer，也會傳送額外的 X-* 標頭；BazaarLink 接受這些標頭。

1
2
Preferred base URL: https://api.bazaarlink.ai/v1
Legacy supported base URL: https://bazaarlink.ai/api/v1

Python：tavily-python

Python 用戶端接受 api_base_url，並將 BazaarLink 金鑰放在 Authorization: Bearer。

1
2
3
4
5
6
7
8
from tavily import TavilyClient

client = TavilyClient(
    api_key="YOUR_BAZAARLINK_API_KEY",
    api_base_url="https://api.bazaarlink.ai/v1",
)

response = client.search("What is new in AI?")

JavaScript：tavily

官方 JavaScript tavily factory 接受 apiBaseURL。請將 API 金鑰放在環境變數或本機 secret store。

1
2
3
4
5
6
7
8
import { tavily } from "@tavily/core";

const client = tavily({
  apiKey: process.env.BAZAARLINK_API_KEY,
  apiBaseURL: "https://api.bazaarlink.ai/v1",
});

const response = await client.search("What is new in AI?");

LangChain：langchain-tavily

已驗證的 LangChain 類別接受 api_base_url，請在 TavilySearch、TavilyExtract 與 TavilyCrawl 上設定。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
from langchain_tavily import TavilySearch, TavilyExtract, TavilyCrawl

search = TavilySearch(
    tavily_api_key="YOUR_BAZAARLINK_API_KEY",
    api_base_url="https://api.bazaarlink.ai/v1",
)
extract = TavilyExtract(
    tavily_api_key="YOUR_BAZAARLINK_API_KEY",
    api_base_url="https://api.bazaarlink.ai/v1",
)
crawl = TavilyCrawl(
    tavily_api_key="YOUR_BAZAARLINK_API_KEY",
    api_base_url="https://api.bazaarlink.ai/v1",
)

純 HTTP

任何 HTTP 用戶端都能以 Authorization: Bearer 與 JSON body 呼叫相同端點。範例使用 Tavily Search。

1
2
3
4
curl -X POST https://api.bazaarlink.ai/v1/search \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is new in AI?"}'

Dify 與 n8n

使用通用 HTTP Request node：POST https://api.bazaarlink.ai/v1/search，帶上 Authorization: Bearer 與 Content-Type: application/json。官方 Dify 與 n8n Tavily node 尚未驗證是否允許自訂 base URL，因此本頁不宣稱支援。

1
2
3
4
5
POST https://api.bazaarlink.ai/v1/search
Authorization: Bearer YOUR_BAZAARLINK_API_KEY
Content-Type: application/json

{"query":"What is new in AI?"}

MCP：已驗證的邊界

官方 npm tavily-mcp 套件將 api.tavily.com 寫死，無法指向 BazaarLink。

現已可用：遠端 HTTP MCP endpoint 已在 https://api.bazaarlink.ai/v1/mcp 提供。請使用 BazaarLink API 金鑰驗證；它提供 search、extract、crawl 與 map。未修改的 npm tavily-mcp 套件仍將 api.tavily.com 寫死，無法重新導向。

Cursor 與 Claude Desktop

不一定需要額外的 npm stdio wrapper。Cursor 與 Claude Desktop 都支援以 URL 和標頭設定遠端 HTTP MCP server。以下 JSON 是計畫中的設定，不代表端點已上線。

計畫中的 Cursor 設定

1
2
3
4
5
6
7
8
9
10
{
  "mcpServers": {
    "bazaarlink-search": {
      "url": "https://api.bazaarlink.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BAZAARLINK_API_KEY}"
      }
    }
  }
}

計畫中的 Claude Desktop 設定

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "mcpServers": {
    "bazaarlink-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.bazaarlink.ai/v1/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}",
        "--transport",
        "http-only"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_BAZAARLINK_KEY"
      }
    }
  }
}