crewai-xpoz

CrewAI tools for Xpoz social media intelligence — access Twitter/X, Instagram, Reddit, and TikTok data in your CrewAI agents.

Installation

pip install crewai-xpoz

Or via the CrewAI Tool Repository:

crewai tool install crewai-xpoz

Quick Start

import os
from crewai import Agent, Task, Crew
from crewai_xpoz import XpozTwitterSearch, XpozInstagramUser

os.environ["XPOZ_API_KEY"] = "your-xpoz-key"  # Get one at xpoz.ai/get-token
os.environ["OPENAI_API_KEY"] = "your-openai-key"

tools = [
    XpozTwitterSearch(),
    XpozInstagramUser(),
]

researcher = Agent(
    role="Social Media Analyst",
    goal="Analyze social media trends and brand presence",
    backstory="An expert social media analyst with deep knowledge of online trends",
    tools=tools,
    verbose=True,
)

task = Task(
    description="What are people saying about AI agents on Twitter this week?",
    expected_output="A summary of the key themes and sentiment around AI agents on Twitter",
    agent=researcher,
)

crew = Crew(agents=[researcher], tasks=[task])
result = crew.kickoff()

You can also pass the API key directly:

tools = [
    XpozTwitterSearch(api_key="your-xpoz-key"),
]

Available Tools

Twitter/X (13 tools)

Instagram (9 tools)

Reddit (9 tools)

TikTok (9 tools)

Tracking (3 tools)

Account (1 tool)

Authentication

Get a free API key at xpoz.ai/get-token.

Set it via environment variable:

export XPOZ_API_KEY=your-key

Or pass it directly when creating tools:

tool = XpozTwitterSearch(api_key="your-key")

Publishing

To publish to the CrewAI Tool Repository:

crewai tool publish --public

Links

• Xpoz Platform
• Documentation
• Get API Key