Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Dùng client Tavily chính thức với BazaarLink

Trỏ các client và tích hợp Tavily đã được xác minh đến BazaarLink bằng cách đổi base URL và dùng API key BazaarLink. Trang này chỉ nêu hành vi đã được xác minh từ mã nguồn.

Base URL và xác thực

Dùng https://api.bazaarlink.ai/v1 làm base URL ưu tiên. Base URL cũ https://bazaarlink.ai/api/v1 vẫn được hỗ trợ. SDK Python gửi Authorization: Bearer cùng các header X-* bổ sung; BazaarLink chấp nhận các header đó.

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

Python: tavily-python

Client Python nhận api_base_url và gửi key BazaarLink dưới dạng 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

Factory tavily JavaScript chính thức nhận apiBaseURL. Hãy giữ API key trong biến môi trường hoặc kho bí mật cục bộ.

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

Các lớp LangChain đã được xác minh nhận api_base_url. Đặt giá trị này cho TavilySearch, TavilyExtract và 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 thuần

Bất kỳ HTTP client nào cũng gọi được endpoint bằng Authorization: Bearer và JSON body. Ví dụ dùng 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 và n8n

Dùng node HTTP Request chung: POST https://api.bazaarlink.ai/v1/search với Authorization: Bearer và Content-Type: application/json. Chưa xác minh node Tavily chính thức của Dify và n8n có cho phép base URL tùy chỉnh, nên trang này không khẳng định điều đó.

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: ranh giới đã xác minh

Gói npm tavily-mcp chính thức hard-code api.tavily.com nên không thể trỏ đến BazaarLink.

Hiện đã có: remote HTTP MCP endpoint khả dụng tại https://api.bazaarlink.ai/v1/mcp. Xác thực bằng API key BazaarLink; endpoint cung cấp search, extract, crawl và map. Gói npm tavily-mcp chưa chỉnh sửa vẫn hard-code api.tavily.com nên không thể chuyển hướng sang endpoint khác.

Cursor và Claude Desktop

Không bắt buộc có npm stdio wrapper riêng. Cả Cursor và Claude Desktop đều hỗ trợ remote HTTP MCP server cấu hình bằng URL và header. Các JSON bên dưới là cấu hình dự kiến, không phải khẳng định endpoint đang hoạt động.

Cấu hình Cursor dự kiến

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}"
      }
    }
  }
}

Cấu hình Claude Desktop dự kiến

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"
      }
    }
  }
}