---
title: "Composio Geçişi"
description: "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ı

```txt
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.

```json
{
  "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:

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

Twexapi MCP görevi:

```txt
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:

```txt
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ş

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