llama-index-tools-xpoz

Xpoz social media intelligence tools for LlamaIndex agents: search and analyze Twitter/X, Instagram, Reddit, and TikTok (posts, user profiles, comments, engagement data) with no social media API keys required.

Installation

pip install llama-index-tools-xpoz

Get a free access key at xpoz.ai/get-token (no credit card) and set it:

export XPOZ_API_KEY=your-access-key

Usage

Five tool specs, one per domain. Give an agent only the platforms it needs:

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from llama_index.tools.xpoz import XpozTwitterToolSpec, XpozRedditToolSpec

tools = XpozTwitterToolSpec().to_tool_list() + XpozRedditToolSpec().to_tool_list()

agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-5.4"),
    system_prompt="You are a social media research assistant. Use the Xpoz tools for data.",
)

response = await agent.run("What are people saying about AI agents on Twitter and Reddit?")
print(response)

Or call tools directly:

from llama_index.tools.xpoz import XpozTwitterToolSpec

spec = XpozTwitterToolSpec()
result = spec.search_twitter_posts("AI agents", limit=5)

Pass api_key explicitly instead of using the environment variable: XpozTwitterToolSpec(api_key="...").

Tool specs

Tips

• When you want the most recent posts, omit start_date / end_date.
• Use the fields parameter to keep responses small, e.g. ["text", "like_count", "created_at"].
• Tracked keywords and users are crawled continuously, which gives later searches better coverage.

Links

Xpoz · Docs · Get a token · support@xpoz.ai

License

MIT