Composio Geçişi

X/Twitter aracısı iş akışlarını Composio tarzı araçlardan Twexapi MCP'ye taşıyın.

Agent’ınız zaten paketlenmiş X/Twitter araçlarını çağırıyorsa ve iş akışını Twexapi MCP’ye taşımak istiyorsanız bu kılavuzu kullanın.

Önkoşullar

Twexapi API anahtarı
Agent’ınızın kullandığı mevcut X/Twitter eylemlerinin listesi
https://api.twexapi.io/mcp adresine bağlı MCP destekli bir runtime
Eski iş akışından bir test prompt’u ve beklenen çıktı

MCP istemcileri için x-api-key: YOUR_API_KEY, REST yedekleri için Authorization: Bearer YOUR_API_KEY kullanın.

Geçiş haritası

Mevcut davranış	Twexapi MCP kalıbı
Tweet arama	`explore(query="advanced search")`, ardından `twexapi_request`
Profil okuma	`explore(category="users")` veya `explore(category="accounts")`
Takipçi alma	`explore(category="followers")`
Yanıt veya alıntı okuma	`explore(category="engagement")`
Gönderi veya yanıt	`read_only: false` katalog girişi kullanın ve onay isteyin

Temsilci talimatı

Replace packaged X/Twitter tools with Twexapi MCP.
First call explore to find the closest Twexapi endpoint.
Then call twexapi_request with the exact method and relative path returned by explore.
Preserve tweet_id, user_id, route_used, has_more, and next_cursor.
Ask for confirmation before read_only: false actions.

Devir sözleşmesi

Taşınan her aracın, downstream adımlar tüketmeden önce kararlı bir devir nesnesi döndürmesini sağlayın.

{
  "route_used": "/twitter/advanced_search/page",
  "method": "POST",
  "source_tool": "legacy_twitter_search",
  "has_more": true,
  "next_cursor": "cursor_123",
  "rows": [
    {
      "tweet_id": "1803006263529541838",
      "author_username": "openai",
      "text": "Example tweet text",
      "created_at": "2026-07-02T10:00:00Z",
      "public_url": "https://x.com/i/web/status/1803006263529541838"
    }
  ]
}

Örnek geçiş

Eski görev:

Search Twitter for AI agent launch announcements and summarize the top posts.

Twexapi MCP görevi:

Use Twexapi MCP to search recent X posts about "AI agent launch".
Call explore first and choose the search endpoint.
Return JSON with route_used, tweets[{tweet_id,text,author_username,created_at,public_url}], has_more, next_cursor, and a short summary.

Doğrulama kontrol listesi

Taşıma öncesinde ve sonrasında satır sayılarını karşılaştırın.
Tüm downstream adımların URL ayrıştırma yerine tweet_id kullandığını doğrulayın.
İmleçlerin agent sohbeti dışında saklandığını onaylayın.
Taşınan her yazma eylemi için insan onayı ekleyin.

Araç çağrısının yeniden yazılması

Eski aracı talimatlarını uyarlarken bu mekanik yeniden yazmayı kullanın.

Eski talimat	Yeni talimat
“Twitter arama aracını çağır”	“`explore(query=\"advanced search\")` çağır, ardından `twexapi_request`.”
“Bu profili getir”	“`explore(category=\"users\")` çağır ve `user_id` koru.”
“Sayfalandırmaya devam et”	“Dönen `next_cursor` değerini kullan; ayrıştırma.”
“Bu tweeti gönder”	“Yazma planı hazırla ve `read_only: false` öncesinde onay iste.”

Regresyon prompt’u

Geçişten önce ve sonra çalıştırın:

Find recent posts about "AI agents" from the last 24 hours.
Return exactly 10 rows with tweet_id, author_username, text, created_at, public_url, route_used, has_more, and next_cursor.
Do not call write endpoints.

Production’a geçiş

Salt okunur görevlerde eski ve yeni iş akışlarını yan yana çalıştırın.
Satır sayılarını, gerekli alanları ve temsili URL’leri karşılaştırın.
Zamanlanmış job’ları Twexapi MCP/REST rotasına geçirin.
Onay prompt’ları test edildikten sonra yazma eylemlerini yeniden etkinleştirin.