llama-index-tools-buywhere

BuyWhere product catalog tools for LlamaIndex agents. Search products, discover deals, and browse categories across 1.5M+ products from Shopee, Lazada, Amazon, Walmart, and 20+ platforms.

pip install llama-index-tools-buywhere

Quick Start

import os
from llama_index.tools.buywhere import BuyWhereToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

os.environ["BUYWHERE_API_KEY"] = "bw_live_xxx"

tool_spec = BuyWhereToolSpec()
agent = FunctionAgent(
    tools=tool_spec.to_tool_list(),
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You are a helpful shopping assistant.",
)

response = agent.run("find wireless headphones under SGD 50 in Singapore")
print(response)

Tools

API

BuyWhereToolSpec

Constructor:

BuyWhereToolSpec(
    api_key: str | None = None,      # API key or BUYWHERE_API_KEY env var
    base_url: str = "https://api.buywhere.ai",
    timeout: float = 30.0,
)

Error Handling

All tool methods return list[Document] — LlamaIndex Document objects with structured metadata for downstream processing.