> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Hashtag Optimizer

> Optimize hashtags and keywords for maximum reach

# AI Hashtag Optimizer

Generate and optimize hashtags and keywords for maximum social media reach.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
flowchart LR
    A[Topic] --> B[AI Hashtag Optimizer]
    B --> C[Trend Analysis]
    C --> D[Optimized Hashtags]
    
    style A fill:#e1f5fe
    style D fill:#c8e6c9
```

## CLI Quickstart

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai recipe run ai-hashtag-optimizer \
  --input '{"topic": "AI agents", "platform": "instagram", "max_hashtags": 30}' \
  --json
```

## Use in Your App (SDK)

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import sys
sys.path.insert(0, 'agent_recipes/templates/ai-hashtag-optimizer')
from tools import generate_hashtags, optimize_keywords

# Generate hashtags
hashtags = generate_hashtags(
    topic="AI agents tutorial",
    platform="instagram",
    max_hashtags=30,
    mix_popularity=True
)

# Optimize keywords for SEO
keywords = optimize_keywords(
    topic="AI agents",
    content_type="video",
    max_keywords=20
)
```

## Input Schema

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "type": "object",
  "properties": {
    "topic": {"type": "string"},
    "platform": {
      "type": "string",
      "enum": ["instagram", "x", "linkedin", "tiktok"]
    },
    "max_hashtags": {"type": "integer", "default": 30},
    "mix_popularity": {"type": "boolean", "default": true}
  }
}
```

## Output Schema

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "hashtags": ["#AIagents", "#MachineLearning", "#Tech"],
  "platform": "instagram",
  "count": 30
}
```

## Platform Limits

| Platform  | Max Hashtags |
| --------- | ------------ |
| Instagram | 30           |
| X         | 5            |
| LinkedIn  | 5            |
| TikTok    | 10           |

## Environment Variables

| Variable         | Required | Description            |
| ---------------- | -------- | ---------------------- |
| OPENAI\_API\_KEY | Yes      | For hashtag generation |

## Related Tools

* [AI Post Copy Generator](/docs/examples/agent-recipes/creator-suite/ai-post-copy-generator)
* [AI Publisher Pack](/docs/examples/agent-recipes/creator-suite/ai-publisher-pack)