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

Spec Tools
XpozTwitterToolSpec search posts, user profile, user posts, post comments, search users, followers/following, users by keywords, count posts
XpozInstagramToolSpec search posts, user profile, user posts, post comments, search users, users by keywords
XpozRedditToolSpec search posts, post with comments, search comments, user profile, search subreddits, subreddit with posts, subreddits by keywords
XpozTiktokToolSpec search videos, videos by hashtags, creator profile, creator videos, video comments, search creators, creators by hashtags
XpozTrackingToolSpec list/add/remove tracked items, account details

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

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for xpoz_developers from gravatar.com xpoz_developers

Credits

Author/Maintainer: Xpoz

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python <4.0, >=3.10

Provides Extra

dev

Tags

ai-agents instagram llama-index llamaindex osint reddit social-listening social-media tiktok twitter xpoz

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llama_index_tools_xpoz-0.1.1.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

llama_index_tools_xpoz-0.1.1-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file llama_index_tools_xpoz-0.1.1.tar.gz.

File metadata

  • Download URL: llama_index_tools_xpoz-0.1.1.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for llama_index_tools_xpoz-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d23888a70031b2d7eb2ddb391f0855daf4a6e7293da8030c3879005c04e4cdd7
MD5 82cd427c3988ca0ae47329f1231b6227
BLAKE2b-256 efd8271759935f9bfa86917aebfcfa52eb8c56968c71f56a785329fb7aad1e47

See more details on using hashes here.

Provenance

The following attestation bundles were made for llama_index_tools_xpoz-0.1.1.tar.gz:

Publisher: release.yml on XPOZpublic/llama-index-tools-xpoz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file llama_index_tools_xpoz-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for llama_index_tools_xpoz-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 998ef0686b2b96643735ec6a337c1a9e7e438e907b13c0f0d495936f4e57a6ba
MD5 b8cca92ac2014a174d8c35a047663bdd
BLAKE2b-256 8c43d9f2e7d0ab36d5ca4864ac9294faebbf5e9aba0146d91c3d705de328bd67

See more details on using hashes here.

Provenance

The following attestation bundles were made for llama_index_tools_xpoz-0.1.1-py3-none-any.whl:

Publisher: release.yml on XPOZpublic/llama-index-tools-xpoz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page