iwantfyi-llamaindex 0.1.0

LlamaIndex tools for iwant.fyi -- reference implementation of the iwant.fyi demand-side protocol v1.1. Lets any LlamaIndex agent express structured purchase intent and receive matched supply across multiple sources.

iwantfyi-llamaindex

LlamaIndex tools for iwant.fyi — the reference implementation of the iwant.fyi demand-side protocol v1.1. Lets any LlamaIndex agent express structured purchase intent and receive matched supply across multiple sources.

pip install iwantfyi-llamaindex

Usage

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from iwantfyi_llamaindex import get_iwant_tools

tools = get_iwant_tools(api_key="iwant_ak_...")

agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You help users find and buy things via iwant.fyi.",
)

response = await agent.run("Find me waterproof running shoes under $120")
print(response)

Get a free API key by registering an agent: POST https://iwant.fyi/api/agents/register (or see /developers).

Tools

Tool	What it does
demand_create_want	Create a buyer Want (structured purchase intent) and return matches.
demand_search	Find matched supply for a query without persisting a Want.
demand_get_want	Retrieve a Want by id with its current matches.
demand_record_outcome	Report viewed/clicked/purchased for attribution + match-quality learning.
demand_list_verticals	Discover supported verticals + spec keys.
demand_list_constraints	Discover the constraint vocabulary.
demand_health	Liveness + active supply sources.

Options

get_iwant_tools(...):

• api_key (required) — iwant_ak_...
• base_url — defaults to https://iwant.fyi
• transport — "mcp" (default) or "http" for the REST fallback
• client — reuse an existing IwantClient (testing / pooling)

License

Apache-2.0. Full protocol spec: iwant.fyi/protocol/v1.