Build an X alert bot
restocks, price drops, market signals

Your watcher script or agent polls the source and holds the last known state. When the state changes, it sends one authenticated POST with publish_now set to true, and the alert tweets in seconds. The posting step is a single call, so all your effort goes into the detection, not the plumbing.

The curl call

# Watcher sees a restock, tweets it instantly.
curl -X POST https://opentweet.io/api/v1/posts \
  -H "Authorization: Bearer ot_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "RESTOCK: Acme Runner (size 10) is back in stock.\nhttps://shop.example.com/acme-runner",
    "publish_now": true
  }'

The same thing in Python, six lines

import requests

def tweet_alert(text):
    requests.post(
        "https://opentweet.io/api/v1/posts",
        headers={"Authorization": "Bearer ot_your_key"},
        json={"text": text, "publish_now": True},
    )

Agent-driven alerts over MCP

If an AI agent is doing the watching and the judgment, give it the hosted MCP server. It gets 30 tools for posting, threading, and scheduling, so it can decide what is worth an alert and publish it as a tool call.

{
  "mcpServers": {
    "opentweet": {
      "type": "streamable-http",
      "url": "https://mcp.opentweet.io/mcp",
      "headers": { "Authorization": "Bearer ot_your_key" }
    }
  }
}

Full endpoint reference in the API docs. Curating a feed rather than firing alerts? See how to build an automated news account.

Ship it in four steps

Frequently asked questions