MCP Sunucusu

Claude, ChatGPT, Cursor ve diğer AI agent'ları Model Context Protocol ile TwexAPI'ye bağlayın. TwexAPI hesabınızla giriş yapın veya bir API anahtarı kullanın.

TwexAPI, https://api.twexapi.io/mcp adresinde bir Model Context Protocol sunucusu çalıştırır. AI asistanları ve kodlama agent’ları bu sunucuyu tweet aramak; profilleri, takipçileri, yanıtları, thread’leri, toplulukları, listeleri ve trendleri okumak için kullanabilir. Her çağrı, bir REST isteği gibi TwexAPI kredilerinizi kullanır.

Bu sayfa API MCP sunucusunu anlatır. Bir agent’ın bunun yerine TwexAPI belgelerinde arama yapmasını istiyorsanız, giriş gerektirmeyen https://docs.twexapi.io/mcp adresindeki Docs MCP sunucusunu kullanın.

Hızlı başlangıç

İstemciye özel adımlar:

Kimlik doğrulama

Sunucu iki tür kimlik bilgisi kabul eder:

API anahtarınızı TwexAPI panelinde oluşturun veya kopyalayın. ChatGPT özel header gönderemediği için her zaman giriş yöntemini kullanır.

Giriş yapmak neye izin verir

• Uygulama yalnızca https://api.twexapi.io/mcp üzerinde çalışan bir token alır. Şifrenizi veya API anahtarınızı asla görmez; hesabınızı değiştiremez ve panelinizi okuyamaz.
• Çağrılar, API anahtarınızla yapılan çağrılarla tamamen aynı şekilde hesabınızın kredilerinden düşülür.
• Okuma erişimi her zaman verilir. Yazma erişimi (twexapi_write ile tweet ve yanıt paylaşma) onay sayfasındaki bir onay kutusudur; salt okunur bağlanmak için işaretini kaldırın.
• Erişim token’ları bir saat geçerlidir ve istemciler bunları otomatik olarak yeniler. Hiçbir uygulamanın 30 gün boyunca kullanmadığı bir yetkilendirmenin süresi dolar.
• Bir istemciyi her bağladığınızda paneldeki Authorized apps (yetkili uygulamalar) altında yeni bir kayıt görünür. Bir uygulamanın erişimini hemen kesmek için Revoke’u seçin. İstemcinin içinde bir bağlayıcıyı kaldırmak, bizim tarafımızda erişimi iptal etmez.

Onaylamadan önce

• Hesabınızda kredisi kalmış etkin bir API anahtarı olmalıdır. Kredi yoksa onay sayfası önce bakiye yüklemenizi ister. İstek 10 dakika geçerli kalır; bu sürede bakiye yükleyip yeniden Approve’u seçebilirsiniz.
• After you approve, you will return to satırını kontrol edin. Burada kullandığınız uygulama yazmalıdır; örneğin claude.ai, chatgpt.com veya masaüstü uygulamaları için bir 127.0.0.1 adresi.

Keşif

MCP istemcileri ihtiyaç duydukları her şeyi sunucunun kendisinden bulur:

Kimlik bilgisi olmayan bir istek, korunan kaynak meta verisi URL’sini belirten bir WWW-Authenticate: Bearer challenge’ı ile 401 döndürür. İstemciler girişi başlatmaları gerektiğini bu challenge’dan anlar. Akışın tamamı için MCP istemcileri için OAuth sayfasına bakın.

Araçlar

Claude gibi istemciler her twexapi_write çağrısından önce onay ister. Beğeni, takip ve doğrudan mesaj gibi diğer yazma işlemleri yalnızca REST API üzerinden kullanılabilir. Girdiler, çıktılar ve kataloğun tamamı için MCP araç referansına bakın.

Krediler ve hatalar

Bir bağlantı sorununu bildirirken X-Request-Id yanıt header’ını ve UTC saatini ekleyin.

Hesap olmadan çağrı başına ödeme

API anahtarı yerine Machine Payments Protocol ile ödeme yapan MCP istemcileri https://api.twexapi.io/mcp/pay adresine bağlanır. Bu uç nokta anonim istekleri kabul eder ve uygun araç çağrılarına bir ödeme challenge’ı ile yanıt verir. Ana /mcp uç noktası her zaman giriş veya API anahtarı gerektirir.

Claude.ai ve Claude Desktop

Claude.ai ve Claude Desktop aynı bağlayıcıları paylaşır; TwexAPI’yi yalnızca bir kez eklemeniz yeterlidir.

Team ve Enterprise planlarında, bir owner’ın önce özel bağlayıcılara izin vermesi gerekebilir.

Agent framework’leri

Agent çalışma ortamları ve script’ler genellikle bir API anahtarı gönderir. Örneğin OpenAI Agents SDK ile:

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://api.twexapi.io/mcp",
        "headers": {"x-api-key": "YOUR_API_KEY"},
    },
) as twexapi:
    # use TwexAPI as a tool provider
    pass

Anahtarı koda gömmek yerine bir ortam değişkeninden veya secret deposundan yükleyin.

MCP ve REST API karşılaştırması

MCP Sunucusu

AI asistanları, IDE agent’ları ve doğal dil iş akışları için en iyisidir. Agent uç noktaları explore ile bulur ve twexapi_request veya twexapi_write ile çağırır.

REST API

Backend servisleri, zamanlanmış işler ve doğrudan entegrasyonlar için en iyisidir. https://api.twexapi.io/* adresini Authorization: Bearer YOUR_API_KEY ile çağırın. Tüm uç noktalara, ayrıntılı sayfalamaya veya SDK koduna ihtiyacınız olduğunda API referansını kullanın.

Bir agent’ın X/Twitter verileriyle doğal dil üzerinden çalışmasını istediğinizde MCP kullanın. Üretim backend’i geliştiriyor veya büyük sonuç kümeleri saklıyorsanız REST kullanın.

Örnek prompt’lar

Bağlandıktan sonra AI agent’ınızdan örneğin şunları isteyebilirsiniz:

Arama ve sorgulama

• Son 24 saatte AI agents hakkındaki son X gönderilerini ara. Tweet ID, yazar, oluşturulma zamanı, beğeni, repost ve tek satırlık özetle ilk 20 tweet’i döndür.
• @elonmusk hesabının Grok veya AI geçen son tweet’lerini bul. Sonuçları konuya göre grupla ve doğrudan X bağlantılarını ekle.
• Şu tweet’i oku: https://x.com/elonmusk/status/2104354931595423762. Gönderiyi özetle, ardından en alakalı yanıtları yanıt ID’leriyle getir.
• 2104354931595423762 ID’li tweet’e benzer tweet’leri getir ve her sonucun neden ilgili olduğunu açıkla.

Profiller ve takip ilişkileri

• @openai profilinin biyografisini oku; kullanıcı adı, görünen ad, kullanıcı ID, konum, takipçi sayısı ve profil URL’sini döndür.
• AI infrastructure için X kullanıcılarını ara. Kullanıcı adı, biyografi, takipçi sayısı ve neden eşleştikleriyle 25 hesap döndür.
• @elonmusk hesabının en yeni takipçilerini getir ve biyografisinde yapay zekâ, startup veya kripto geçen hesapları belirle.
• @sama için cursor ile sayfalanmış bir takipçi sayfası getir, ilk 20 kullanıcıyı döndür ve bir sonraki çalıştırma için next_cursor değerini sakla.

Trendler

• Desteklenen tüm küresel trend ülkelerini göster, ardından united-states için en popüler trend konuları getir.
• united-states için technology konusu ve AI içerik etiketiyle trend tweet’leri getir. Tweet ID’lerini, yazarları ve etkileşim metriklerini döndür.
• united-states, japan ve united-kingdom trend konularını karşılaştır ve bölgeye göre farkları özetle.

Yanıtlar, alıntılar ve thread’ler

• https://x.com/elonmusk/status/2104354931595423762 tweet’ine gelen yanıtları getir, alaka düzeyine göre sırala ve yanıt ID, yazar, metin ve beğeni sayısını döndür.
• 2104354931595423762 ID’li tweet’i retweetleyen 50 kullanıcıyı listele. Varsa kullanıcı ID, kullanıcı adı, görünen ad ve takipçi sayısını döndür.
• 2104354931595423762 ID’li tweet’in alıntı tweet’lerini getir ve alıntıları destekleyici, eleştirel veya nötr olarak sınıflandır.
• 2104354931595423762 ID’li tweet’in tüm thread’ini çıkar ve bir Markdown taslağına dönüştür.

Makaleler, topluluklar ve listeler

• 2104354931595423762 X makalesini Markdown olarak getir ve 5 maddelik bir yönetici özetine dönüştür.
• AI builders için X topluluklarını ara. Topluluk ID, ad, üye sayısı ve açıklamayı döndür.
• AI founders için listeleri ara. Liste ID, ad, açıklama ve üye sayısıyla ilk 10 listeyi döndür.

Framework rehberleri

Tercih ettiğiniz framework’te TwexAPI MCP araçlarıyla agent’lar geliştirin:

AI agent skill’i

TwexAPI skill’i, AI kodlama agent’larına MCP bağlantısı gerektirmeden TwexAPI API’si hakkında derin bilgi verir. Agent’ınızın API entegrasyonları yazması, MCP bağlantılarını yapılandırması ve TwexAPI en iyi uygulamalarını kullanması için kurun.

npx skills add twexapi-dev/x-api-scraper-cli