--- title: "MCP araç referansı" description: "Uç nokta keşfi, kimlik doğrulamalı API çağrıları, iş akışı devri ve güvenli agent yürütmesi için Twexapi MCP araçları." --- Twexapi API MCP sunucusu 2 araç sunar: `explore` ve `twexapi_request`. `x-api-key` veya OAuth 2.1 Bearer kimlik doğrulamasıyla `https://api.twexapi.io/mcp` adresine bağlanın. Agent'lar `twexapi_request` çağırmadan önce API kataloğunu incelemek için `explore` kullanmalıdır. Bu, uç nokta seçimini açık tutar, agent'ın istek şemalarını korumasına yardımcı olur ve MCP üzerinden kullanılamayan yollara yanlışlıkla çağrı yapılmasını önler. ## Araçlar | Araç | Amaç | | --- | --- | | `explore` | API uç nokta kataloğunda arama yapın; yöntemler, yollar, kategoriler, parametreler, örnekler ve güvenlik bayrakları döndürün. | | `twexapi_request` | İzin listesindeki göreli yollara karşı kimlik doğrulamalı Twexapi API çağrıları yürütün. | ## `explore` API uç nokta kataloğunda arama yapın. Salt okunur, X/Twitter ağ çağrısı yok ve uç nokta kredisi tüketilmez. Çağrı yine de API anahtarı veya OAuth Bearer token ile MCP kimlik doğrulaması gerektirir. Mevcut uç noktaları keşfetmek, parametreleri kontrol etmek, kategorileri karşılaştırmak ve çağrı yürütmeden doğru API yolunu bulmak için `explore` kullanın. ### Girdi | Ad | Tür | Gerekli | Açıklama | | --- | --- | --- | --- | | `query` | string | Hayır | Uç nokta adı, yöntem, yol, kategori, açıklama ve örneklerde anahtar kelime araması. | | `category` | string | Hayır | `trending`, `search`, `users`, `articles` veya `write` gibi tam kategori filtresi. | | `include_writes` | boolean | Hayır | Yan etkili uç noktaları dahil edin. Yazma uç noktaları `read_only: false` olarak işaretlenir. | ### Katalog şekli ```ts interface EndpointInfo { name: string; method: string; path: string; category: string; description: string; read_only: boolean; parameters_schema?: Record; example?: { method: string; path: string; query?: Record; body?: unknown; }; } ``` ### Örnekler Trend uç noktalarını bulun: ```json { "category": "trending" } ``` Anahtar kelimeyle arayın: ```json { "query": "advanced search tweets" } ``` Yazma yeteneği olan uç noktaları dahil edin: ```json { "query": "create tweet", "include_writes": true } ``` ## `twexapi_request` Twexapi hesabınıza karşı API çağrıları yürütün. Kimlik doğrulama MCP isteğinden otomatik enjekte edilir; agent yalnızca uç nokta yöntemi, göreli yol ve isteğe bağlı sorgu/gövde verisini iletir. ### Girdi | Ad | Tür | Gerekli | Açıklama | | --- | --- | --- | --- | | `method` | string | Evet | `explore` tarafından döndürülen HTTP yöntemi, örn. `GET` veya `POST`. | | `path` | string | Evet | Göreli Twexapi API yolu. Mutlak URL'ler reddedilir. | | `query` | object | Hayır | İstek için sorgu parametreleri. | | `body` | object, array, or scalar | Hayır | GET dışı istekler için JSON istek gövdesi. | :::warning Önce `explore` çağırın ve katalog tarafından döndürülen tam göreli yolu kullanın. `twexapi_request` ile `/openapi.json`, belge sayfaları, dashboard'lar veya gizli çerçeve rotalarını çağırmayın. ::: ### Yanıt sözleşmesi `twexapi_request` MCP yürütme meta verilerini ve altta yatan REST yanıtını döndürür: ```json { "status_code": 200, "endpoint": "list_global_trending_countries", "method": "GET", "path": "/twitter/global-trending/countries", "result": { "code": 200, "msg": "success", "data": [] } } ``` `result` içinden ID'ler, imleçler, görev ID'leri, kredi alanları ve yazma işlemi ID'leri gibi kalıcı alanları koruyun. Bir sayfada `has_more` ve `next_cursor` varsa imleci `explore` tarafından döndürülen belgelenmiş takip uç noktasına veya sorgu parametresine iletin. ## İş akışı örnekleri Bu örnekler agent'ın üretmesi gereken şekli gösterir. Gerçek kullanımda agent'ın güncel şemayı doğrulayabilmesi için önce `explore` çalıştırın. ### Devir satırlarıyla tweet arama ```json { "method": "POST", "path": "/twitter/advanced_search/page", "body": { "searchTerms": ["from:openai AI agents"], "maxItems": 20, "sortBy": "Latest" } } ``` Agent'dan kompakt bir devir nesnesi döndürmesini isteyin: ```json { "source": "twexapi_mcp", "job": "tweet_search", "route_used": "/twitter/advanced_search/page", "query": "from:openai AI agents", "rows": [ { "tweet_id": "1803006263529541838", "text": "...", "author_username": "openai", "created_at": "..." } ], "has_more": false, "next_cursor": null } ``` ### Trend tweet'leri getirme ```json { "method": "GET", "path": "/twitter/global-trending/tweets", "query": { "country": "united-states", "topic": "technology", "content": "AI", "count": 20 } } ``` Varsa `country`, `topic`, `content`, tweet ID'leri, yazar kullanıcı adları, etkileşim alanları, `has_more` ve `next_cursor` değerlerini saklayın. ### Takipçileri CRM'e aktarma ```json { "method": "GET", "path": "/twitter/followers/openai/50" } ``` `user_id`, `username`, `name`, `description`, `followers_count`, kaynak hesabı ve sayfalama/görev alanlarını saklayın. Uç nokta görev ID döndürürse saklayın ve belgelenmiş durum/sonraki uç noktayı yoklayın. ### X makalesini Markdown olarak okuma ```json { "method": "GET", "path": "/x/article/1803006263529541838/markdown" } ``` Makale ID'si, başlık, yazar, Markdown gövdesi, çıkarılan bağlantılar ve kaynak URL'yi saklayın. ### Tweet veya yanıt gönderme ```json { "method": "POST", "path": "/twitter/tweets/create", "body": { "tweet_content": "Hello from Twexapi MCP", "reply_tweet_id": null, "media_url": null } } ``` :::warning `read_only: false` olan her uç noktayı üretim eylemi sayın. Gönderi, yanıt, takip, engelleme, silme, yer imi veya DM göndermeden önce açık kullanıcı onayı isteyin. ::: `tweet_id`, `write_action_id`, `status`, `charged_credits`, yanıt hedefi, medya URL'leri ve kullanıcı onay kaydını saklayın. ## Agent devir desenleri MCP JSON döndürür. Agent kuyrukları, CRM'ler, elektronik tablolar, veri ambarları ve no-code iş akışları için orijinal iş, kullanılan rota, saklanacak normalize satırlar veya ID'ler ile sonraki imleç veya yoklanacak görevi içeren küçük kalıcı bir nesne döndürün. ### Tweet aramadan JSON'a `POST /twitter/advanced_search/page` çağırın. Tweet ID'leri, metin, yazar meta verisi, oluşturulma zamanı, bağlantılar, `has_more`, `next_cursor` ve orijinal sorguyu saklayın. ### Yanıtları kazıma Sınırlı sayfa için `GET /twitter/tweets/{tweet_id}/replies/{count}` veya imleç tabanlı sayfalama için `GET /twitter/tweets/{tweet_id}/replies/page` çağırın. Yanıt ID'leri, yazar kullanıcı adları, metin, metrikler, `has_more` ve `next_cursor` saklayın. ### Takipçileri dışa aktarma `explore` tarafından döndürülen sayfa/görev uç noktaları veya `GET /twitter/followers/{screen_name}/{count}` çağırın. Kullanıcı ID'leri, kullanıcı adları, adlar, biyolar, takipçi sayıları, kaynak hesap, görev ID ve sonraki imleci saklayın. ### Yazma işlemlerini izleme Yazma uç noktaları için uç nokta yolunu, gövde hash'ini veya onay metnini, dönen tweet ID veya yazma işlemi ID'sini, durumu, ücretlendirilen kredileri ve medya referanslarını saklayın. ### DM gönderme DM uç noktasını yalnızca kullanıcı onayından sonra çağırın. Mesaj ID, alıcı kullanıcı ID, hesap, medya referansları ve teslim durumunu saklayın. Tam DM gövdelerini paylaşılan MCP çıktılarından çıkarın. ## Uç nokta kategorileri | Kategori | Yaygın kullanımlar | | --- | --- | | `trending` | Ülkeler, konular, içerik etiketleri ve trend tweet'ler. | | `search` | Gelişmiş arama, hashtag araması, cashtag araması ve sayfalı arama. | | `users` | Kullanıcı arama, hesap doğrulama, kullanıcı araması ve hesap durumu. | | `tweets` | Yanıtlar, thread'ler, tweet arama, benzer tweet'ler, duygu, alıntılar, retweet edenler ve beğenenler. | | `followers` | Takipçiler, takip edilenler, son takipçiler ve sayfalı ilişki verisi. | | `communities` | Topluluk meta verisi, üyeler, tweet'ler, arama ve topluluk tweet araması. | | `lists` | Liste oluşturma, liste tweet'leri, üyeler, aboneler ve liste araması. | | `dm` | DM durumu, DM gönderme ve DM geçmişi. | | `articles` | X makale arama, Markdown getirme, taslaklar, kapaklar, içerik güncellemeleri ve yayınlama. | | `timeline` | Kullanıcı zaman çizelgeleri ve tweet/yanıt sayfaları. | | `accounts` | Cookie doğrulama, hesap bilgisi, hesap doğrulama ve hesap durumu. | | `write` | Gönderi, yanıt, beğeni, retweet, takip, engelleme, yer imi, silme ve DM gönderme gibi yan etkili eylemler. | ## Hata yönetimi MCP kimlik doğrulaması başarısız olursa araç çalışmaz. İstemci JSON-RPC hatası alır: ```json { "jsonrpc": "2.0", "error": { "code": 401, "message": "Missing MCP API token" } } ``` `twexapi_request` çalışır ve altta yatan Twexapi API 2xx dışı yanıt döndürürse MCP meta verilerini ve Twexapi hatasını koruyun: ```json { "status_code": 403, "endpoint": "get_global_trending_tweets", "method": "GET", "path": "/twitter/global-trending/tweets", "result": { "detail": "Credits exhausted or action not allowed." } } ``` | Durum | Anlam | | --- | --- | | `401` | Araç çalışmadan MCP kimlik doğrulaması başarısız; `x-api-key` veya Bearer auth kontrol edin. | | `403` | API anahtarı kullanılamıyor, krediler tükendi veya eyleme izin yok. | | `429` | Hız sınırı aşıldı. Limit penceresinden sonra yeniden deneyin. | | `5xx` | Servis tarafı hatası veya üst akış X/Twitter getirme sorunu. | REST ve MCP kurtarma desenleri için [Error Handling](/guides/error-handling) ve [Rate Limits](/guides/rate-limits) sayfalarına bakın.