공식 Tavily 클라이언트를 BazaarLink에서 사용하기

검증된 Tavily 클라이언트와 통합을 base URL 변경 및 BazaarLink API 키로 BazaarLink에 연결하세요. 이 페이지는 소스에서 검증한 동작만 다룹니다.

Base URL 및 인증

권장 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 팩토리는 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 노드를 사용하세요. Authorization: Bearer와 Content-Type: application/json을 포함해 POST https://api.bazaarlink.ai/v1/search를 호출합니다. 공식 Dify 및 n8n Tavily 노드가 사용자 지정 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 엔드포인트가 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 서버를 지원합니다. 아래 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"
      }
    }
  }
}