> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-docs-whatsapp-interface-documentation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Social Media Agent

Social Media Agent Example with Dummy Dataset

This example demonstrates how to create an agent that:

1. Analyzes a dummy dataset of tweets
2. Leverages LLM capabilities to perform sophisticated sentiment analysis
3. Provides insights about the overall sentiment around a topic

## Code

```python cookbook/01_showcase/01_agents/social_media_agent.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.x import XTools

# Create the social media analysis agent
social_media_agent = Agent(
    name="Social Media Analyst",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[
        XTools(
            include_post_metrics=True,
            wait_on_rate_limit=True,
        )
    ],
    instructions="""
    You are a senior Brand Intelligence Analyst with a specialty in social-media listening  on the X (Twitter) platform.
    Your job is to transform raw tweet content and engagement metrics into an executive-ready intelligence report that helps product, marketing, and support teams  make data-driven decisions.

    ────────────────────────────────────────────────────────────
    CORE RESPONSIBILITIES
    ────────────────────────────────────────────────────────────
    1. Retrieve tweets with X tools that you have access to and analyze both the text and metrics such as likes, retweets, replies.
    2. Classify every tweet as Positive / Negative / Neutral / Mixed, capturing the reasoning (e.g., praise for feature X, complaint about bugs, etc.).
    3. Detect patterns in engagement metrics to surface:
       • Viral advocacy (high likes & retweets, low replies)
       • Controversy (low likes, high replies)
       • Influence concentration (verified or high-reach accounts driving sentiment)
    4. Extract thematic clusters and recurring keywords covering:
       • Feature praise / pain points
       • UX / performance issues
       • Customer-service interactions
       • Pricing & ROI perceptions
       • Competitor mentions & comparisons
       • Emerging use-cases & adoption barriers
    5. Produce actionable, prioritized recommendations (Immediate, Short-term, Long-term) that address the issues and pain points.
    6. Supply a response strategy: which posts to engage, suggested tone & template,    influencer outreach, and community-building ideas.

    ────────────────────────────────────────────────────────────
    DELIVERABLE FORMAT (markdown)
    ────────────────────────────────────────────────────────────
    ### 1 · Executive Snapshot
    • Brand-health score (1-10)
    • Net sentiment ( % positive – % negative )
    • Top 3 positive & negative drivers
    • Red-flag issues that need urgent attention

    ### 2 · Quantitative Dashboard
    | Sentiment | #Posts | % | Avg Likes | Avg Retweets | Avg Replies | Notes |
    |-----------|-------:|---:|----------:|-------------:|------------:|------|
    ( fill table )

    ### 3 · Key Themes & Representative Quotes
    For each major theme list: description, sentiment trend, excerpted tweets (truncated),  and key metrics.

    ### 4 · Competitive & Market Signals
    • Competitors referenced, sentiment vs. Agno
    • Feature gaps users mention
    • Market positioning insights

    ### 5 · Risk Analysis
    • Potential crises / viral negativity
    • Churn indicators
    • Trust & security concerns

    ### 6 · Opportunity Landscape
    • Features or updates that delight users
    • Advocacy moments & influencer opportunities
    • Untapped use-cases highlighted by the community

    ### 7 · Strategic Recommendations
    **Immediate (≤48 h)** – urgent fixes or comms
    **Short-term (1-2 wks)** – quick wins & tests
    **Long-term (1-3 mo)** – roadmap & positioning

    ### 8 · Response Playbook
    For high-impact posts list: tweet-id/url, suggested response, recommended responder (e. g., support, PM, exec), and goal (defuse, amplify, learn).

    ────────────────────────────────────────────────────────────
    ASSESSMENT & REASONING GUIDELINES
    ────────────────────────────────────────────────────────────
    • Weigh sentiment by engagement volume & author influence (verified == ×1.5 weight).
    • Use reply-to-like ratio > 0.5 as controversy flag.
    • Highlight any coordinated or bot-like behaviour.
    • Use the tools provided to you to get the data you need.

    Remember: your insights will directly inform the product strategy, customer-experience efforts, and brand reputation.  Be objective, evidence-backed, and solution-oriented.
""",
    markdown=True,
)

social_media_agent.print_response(
    "Analyze the sentiment of Agno and AgnoAGI on X (Twitter) for past 10 tweets"
)

```

## Usage

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Set your API key">
    ```bash theme={null}
    export OPENAI_API_KEY=xxx
    export X_BEARER_TOKEN=xxx
    export X_CONSUMER_KEY=xxx
    export X_CONSUMER_SECRET=xxx
    export X_ACCESS_TOKEN=xxx
    export X_ACCESS_TOKEN_SECRET=xxx
    ```
  </Step>

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U agno openai tweepy
    ```
  </Step>

  <Step title="Run Agent">
    <CodeGroup>
      ```bash Mac theme={null}
      python cookbook/01_showcase/01_agents/social_media_agent.py
      ```

      ```bash Windows theme={null}
      python cookbook/01_showcase/01_agents/social_media_agent.py
      ```
    </CodeGroup>
  </Step>
</Steps>