İçeriğe geç
Twexapi
Türkçe
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓gezin↵aç⌘Jönizle
Bu sayfada

MCP Sunucusu

AI aracılarını Model Bağlam Protokolü aracılığıyla Twexapi'ye bağlayın.

AI Aracılarını MCP aracılığıyla bağlayın

Twexapi, AI aracılarının ve geliştirme araçlarının Twexapi hesabınızla programlı bir şekilde etkileşimde bulunmasına olanak tanıyan bir Model Bağlam Protokolü sunucusunu çalıştırır.

Bu sayfa, kimliği doğrulanmış API eylemleri için “https://api.twexapi.io/mcp” adresindeki API MCP sunucusunu kapsar. Salt okunur belge araması için “https://docs.twexapi.io/mcp” adresindeki Docs MCP sunucusunu kullanın.

Bağlantı

Protokol

MCP istemcileri için Akışlı HTTP aktarımlı HTTP.

Uç nokta

İstemcileri şuraya bağlayın:

https://api.twexapi.io/mcp

API sunucusu hem ‘https://api.twexapi.io/mcp’ hem de ‘https://api.twexapi.io/mcp/’ kabul eder. İstemci açıkça normalleştirmediği sürece, istemci yapılandırmalarında eğik çizgi olmayan URL’yi kullanın.

Kimlik doğrulama

Çalışma alanınız için OAuth etkinleştirildiğinde “x-api-key”de bir Twexapi API anahtarı veya bir OAuth 2.1 Taşıyıcı belirteci kullanın.

MCP sunucusu keşif meta verileri şu adreste mevcuttur:

https://api.twexapi.io/.well-known/mcp.json

‘GET /.well-known/mcp.json’ doğrudan MCP kayıt defteri sunucu kartı JSON’unu döndürür. ‘GET /.well-known/mcp/server-card.json’, iç içe geçmiş sunucu kartı yolunu okuyan istemciler için aynı kartı döndürür.

Kayıt defteri kartı istemcileri, API anahtarı kimlik doğrulamasıyla “https://api.twexapi.io/mcp” için “aktarılabilir-http” uzaktan kumandası alır. Aşağıdaki doğrudan istemci örnekleri, istemci özel başlıkları desteklediğinde aynı anahtarı “x-api-key” ile gönderebilir.

Kimlik doğrulama

MCP sunucusu şu kimlik doğrulama yöntemlerini destekler:

  • API anahtarı (“x-api-key” başlığı): Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode ve Claude Desktop tarafından uzak köprüler aracılığıyla kullanılır. MCP anlaşması sırasında anahtarınızı iletin.
  • Bearer token (Authorization: Bearer <token>): Yetkilendirme başlıklarını tercih eden istemciler tarafından kullanılır. Bu, bir Twexapi API anahtarı veya OAuth etkinleştirildiğinde bir OAuth jetonu olabilir.

API anahtarınızı Twexapi kontrol panelinden oluşturun.

Nasıl çalışır?

MCP sunucusu 2 araç sunar:

explore

Twexapi API kataloğunda arama yapın. Bu bir keşif aracıdır: uç nokta adlarını, yöntemlerini, yollarını, kategorilerini, parametre şemalarını, örnekleri ve güvenlik işaretlerini döndürür.

twexapi_request

Kimliği doğrulanmış Twexapi API çağrılarını yürütün. Maliyet, temeldeki son noktayı takip eder.

Aracı önce “explore” ile arama yapar, ardından döndürülen yöntem ve göreceli yolla twexapi_requesti çağırır. Kimlik doğrulama, MCP isteğinden otomatik olarak eklenir.

explore aracı

Bellek içi API uç nokta kataloğunda arama yapar. Çağrı hâlâ bir API anahtarı veya Taşıyıcı belirteci aracılığıyla MCP kimlik doğrulaması gerektiriyor.

interface EndpointInfo {
  name: string;
  method: string;
  path: string;
  category: string; // trending, search, users, tweets, followers, engagement, communities, lists, dm, articles, timeline, accounts, write
  description: string;
  read_only: boolean;
  parameters_schema?: Record<string, unknown>;
  example?: Record<string, unknown>;
}

twexapi_request aracı

İzin verilenler listesindeki Twexapi REST uç noktalarına karşı API çağrılarını yürütür.

declare const twexapi_request: {
  method: string;
  path: string;
  query?: Record<string, unknown>;
  body?: unknown;
};

Örnek çağrı:

{
  "method": "GET",
  "path": "/twitter/global-trending/countries"
}

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

MCP Sunucusu

Yapay zeka aracıları, IDE entegrasyonları ve doğal dil iş akışları için en iyisi. “X-api-key” veya Bearer auth ile “https://api.twexapi.io/mcp” adresine bağlanın. Aracılar, uç nokta araması için “explore”u ve kimliği doğrulanmış API çağrıları için twexapi_requesti kullanır.

REST API’si

Arka uç hizmetleri, otomasyon komut dosyaları ve doğrudan programatik erişim için en iyisi. Authorization: Bearer <token> ile https://api.twexapi.io/* adresini çağırın. Uç noktalar, sayfalandırma, yanıt işleme veya doğrudan SDK kodu üzerinde ayrıntılı kontrole ihtiyaç duyduğunuzda API referansını kullanın.

Bir aracının X/Twitter verileriyle doğal dil aracılığıyla etkileşimde bulunmasını istediğinizde MCP’yi kullanın. Bir üretim arka ucu, zamanlanmış iş veya doğrudan entegrasyon oluştururken REST’i kullanın.

Kurulum

Web ve terminal istemcileri

Claude.ai

Claude.ai, çalışma alanınız için MCP konektörleri etkinleştirildiğinde uzak MCP sunucularına bağlanabilir. Sunucu URL’si olarak https://api.twexapi.io/mcp kullanın. OAuth’un etkin olduğu çalışma alanları, kimlik doğrulamayı tarayıcıda tamamlayabilir; API anahtarı istemcileri “x-api-key” kullanmalıdır.

Claude Masaüstü

Claude Desktop yalnızca stdio aktarımını destekler. Köprü olarak ‘mcp-remote’ npm paketini kullanın:

{
  "mcpServers": {
    "twexapi": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.twexapi.io/mcp",
        "--header",
        "x-api-key:twexapi_YOUR_KEY_HERE"
      ]
    }
  }
}

Claude Kodu

.mcp.json dosyanıza ekleyin:

{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

Kodeks CLI

~/.codex/config.toml dosyasına ekleyin:

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" }

Düzenleyici istemcileri

İmleç

~/.cursor/mcp.json (genel) veya .cursor/mcp.json (proje) dosyasına ekleyin:

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

VS Kodu

.vscode/mcp.json (proje) dosyasına ekleyin veya MCP: Açık Kullanıcı Yapılandırmasını (genel) kullanın:

{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

Rüzgar sörfü

~/.codeium/windsurf/mcp_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

Açık Kod

’opencode.json’a ekle:

{
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

SohbetGPT

ChatGPT’yi Twexapi’ye bağlamanın 3 yolu vardır:

Seçenek 1: Özel GPT

Özel bir GPT oluşturun ve API dağıtımınızdaki OpenAPI şemasını kullanarak Twexapi’yi Eylem olarak ekleyin. Kurulumunuza bağlı olarak kimlik doğrulamayı API anahtar başlığına veya Taşıyıcı belirtecine ayarlayın.

Seçenek 2: Agent SDK’sı

Bir aracı çalışma zamanından Akış Yapılabilir HTTP MCP’yi kullanın:

from agents.mcp import MCPServerStreamableHttp

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

Seçenek 3: Geliştirici Modu

ChatGPT ortamınız MCP bağlayıcılarını desteklediğinde, uç nokta olarak “https://api.twexapi.io/mcp” ile Twexapi’yi ekleyin. OAuth’un etkin olduğu çalışma alanları, tarayıcıda kimlik doğrulamayı tamamlayabilir.

Örnek istemler

Bağlandıktan sonra AI temsilcinize aşağıdaki gibi sorular sorabilirsiniz:

Arama ve arama

  • Son 24 saatteki “AI ajanları” hakkındaki son X gönderilerini arayın. Tweet kimliği, yazar, oluşturulma zamanı, beğeniler, yeniden gönderiler ve tek satırlık özet ile en iyi 20 tweet’i döndürün.
  • @elonmuskun Grok veya AIden bahseden son tweetlerini bulun. Sonuçları konuya göre gruplayın ve doğrudan X bağlantılarını ekleyin.
  • Bu tweet’i okuyun: https://x.com/elonmusk/status/1803006263529541838. Gönderiyi özetleyin, ardından en alakalı yanıtları alın ve yanıt kimliklerini gösterin.
  • Tweet ID ‘1803006263529541838’ için benzer tweetler alın ve her sonucun neden ilişkili olduğunu açıklayın.

Kullanıcı profilleri ve takipler

  • @openai profil biyografisini okuyun ve kullanıcı adını, görünen adı, kullanıcı kimliğini, konumu, takipçi sayısını ve profil URL’sini döndürün.
  • “Yapay zeka altyapısı” için X kullanıcısını arayın. Kullanıcı adı, biyografisi, takipçi sayısı ve neden eşleştiklerini içeren 25 hesabı döndürün.
  • @elonmusk için en son takipçileri alın, ardından hangi hesapların biyografilerinde yapay zekadan, girişimlerden veya kriptodan bahsettiğini belirleyin.
  • ‘@sama’ için imleçle sayfalandırılmış bir takipçi sayfası çekin, ilk 20 kullanıcıyı döndürün ve sonraki çalıştırma için ’next_cursor’u koruyun.
  • ‘44196397’, ‘elonmusk’ ve ‘openai’ hesaplarının doğrulanmış veya kuruluşa bağlı olup olmadığını kontrol edin.

Trendler

  • Desteklenen tüm küresel trend ülkelerini gösterin, ardından “Amerika Birleşik Devletleri” için en önemli trend konularını getirin.
  • Konusu ‘teknoloji’ ve içerik etiketi ‘AI’ olan ‘Amerika Birleşik Devletleri’ için trend olan tweet’leri getirin. Tweet kimliklerini, yazarları ve etkileşim ölçümlerini döndürün.
  • Bugün Amerika Birleşik Devletleri’nde “AI”, “Bitcoin” veya “Grok”un trend olup olmadığını kontrol edin. Geri dönen tweetlerdeki kanıtları açıklayın.
  • “Amerika Birleşik Devletleri”, “Japonya” ve “Birleşik Krallık” için trend olan konuları karşılaştırın ve bölgeye göre nelerin farklı olduğunu özetleyin.

Ekstraksiyonlar

  • “https://x.com/elonmusk/status/1803006263529541838” adresine verilen yanıtları alın, alaka düzeyine göre sıralayın ve yanıt kimliğini, yazarı, metni ve beğeni sayısını döndürün.
  • ‘1803006263529541838’ tweet kimliğini retweetleyen 50 kullanıcıyı listeleyin. Varsa kullanıcı kimliğini, kullanıcı adını, görünen adı ve takipçi sayısını döndürün.
  • Get quote tweets for tweet ID 1803006263529541838, then classify quotes as supportive, critical, or neutral.
  • ‘1803006263529541838’ tweet ID’sinin tamamını çıkarın ve Markdown taslağına dönüştürün.
  • Get all tweets and replies for @elonmusk with a count of 20, then separate original posts from replies.

Makaleler

  • X makalesi ’1803006263529541838’i Markdown olarak getirin ve 5 maddelik yönetici özetine dönüştürün.
  • ‘1803006263529541838’ ve ‘1803006263529541839’ kimliklerine sahip X makalelerini toplu getir; başlığı, yazarı, yayınlanma zamanını ve özeti döndürür.
  • Bu X makalesini Markdown olarak okuyun, tüm bağlantıları çıkarın ve bülten tarzında temiz bir özet oluşturun.

Topluluklar ve listeler

  • X topluluklarında “Yapay zeka geliştiricileri”ni arayın. Topluluk kimliğini, adını, üye sayısını ve açıklamasını döndürün.
  • Tweet türü ‘En Son’ ve hedef sayısı ‘20’ olan topluluk kimliği ’1234567890123456789’dan en son tweet’leri alın.
  • ‘Yapay zeka kurucuları’ için arama listeleri. Liste kimliği, ad, açıklama ve üye sayısıyla birlikte ilk 10 listeyi döndürün.
  • ‘987654321098765432’ numaralı listeden üyeleri alın, sonraki imleci dahil edin ve sonucu bir potansiyel müşteri tablosu olarak biçimlendirin.

X yazma eylemleri

  • Şöyle bir tweet yayınlayın: ’Twexapi entegrasyonumuzun v2.0’ını az önce gönderdim. MCP kurulumu artık 2 dakikadan az sürüyor.`
  • ‘1803006263529541838’ tweet kimliğine şu şekilde yanıt verin: ’Bu yararlı bir örnek. Twexapi MCP aracılığıyla test ettim.`
  • Resim URL’si ‘https://example.com/launch.png’ olan ve şu metni içeren bir tweet oluşturun: ‘Yeni lansman: Twexapi MCP artık aracı iş akışlarını destekliyor.’
  • ‘https://x.com/elonmusk/status/1803006263529541838’ adresine kısa ve teknik bir tarzda bir yanıt taslağı hazırlayın ancak göndermeyin.

Hesap ve kullanım

  • MCP isteğimin “/twitter/global-trending/tweets”e neden “401” döndürdüğünü açıklayın ve kontrol etmem gereken başlıkları listeleyin.
  • MCP isteğimin neden ‘403 Kullanılabilir kredi yok!’ döndürdüğünü ve yeniden denemeden önce ne yapmam gerektiğini açıklayın.
  • Yüksek hacimli takipçi çıkarma işleminin neden ‘429’ döndürdüğünü açıklayın, ardından yeniden deneme ve sayfalandırma planı önerin.
  • Bu görevin MCP’yi mi yoksa doğrudan REST’i mi kullanacağına karar verin: ‘her sabah @openai için 10.000 takipçi çekin ve bunları veritabanımda saklayın’.

Çerçeve kılavuzları

Tercih ettiğiniz çerçevede Twexapi MCP araçlarıyla aracılar oluşturun:

LangChain

Twexapi MCP araçlarını LangChain ve LangGraph aracılarına bağlayın.

CrewAI

Bir Twexapi MCP bağlantısını paylaşan araştırma ekipleri oluşturun.

Pydantic AI

Streamable HTTP MCP araçlarıyla tür uyumlu aracılar kullanın.

Google ADK

Gemini destekli ADK aracılarına Twexapi araçlarını ekleyin.

Mastra

TypeScript aracılarını uzak Twexapi MCP araçlarına bağlayın.

No-code iş akışları

Temsilci çıktılarını n8n, Zapier, Make ve Pipedream’e aktarın.

Yapay zeka ajanı becerisi

Twexapi becerisi, AI kodlama aracılarına MCP bağlantısı gerektirmeden Twexapi API’si hakkında derin bilgi sağlar. Temsilcinizin API entegrasyonları yazmasına, MCP bağlantılarını yapılandırmasına ve Twexapi en iyi uygulamalarını kullanmasına olanak sağlamak için bunu yükleyin.

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

Bu sayfa yardımcı oldu mu?