Paperclip

Ataç aracılarında tweet araması, profiller, zaman çizelgeleri ve trend olan tweet'ler için TwexAPI Paperclip eklentisini yükleyin.

TwexAPI Paperclip eklentisi, Paperclip temsilcilerine altı adet salt okunur Twitter/X aracı ekler. Belgelenen TwexAPI REST rotalarını yazılı araç şemaları, gizli destekli kimlik doğrulama ve öngörülebilir JSON sonuçlarıyla sarar.

Bir Paperclip temsilcisinin ham HTTP çağrıları yazmadan tweet araması, profil araması, kullanıcı araması, zaman çizelgesi okumaları veya küresel trend tweet’lere ihtiyacı olduğunda bu eklentiyi kullanın.

Araçlar

Temsilci görevi	Ataç aracı	TwexAPI rotası
Tweet’lerde ara	`twexapi.search_tweets`	`POST /twitter/advanced_search/page`
Bir tweet okuyun	`twexapi.lookup_tweet`	`POST /v2/tweet/detail`
Kullanıcıları ara	`twexapi.search_users`	`GET /twitter/search-user/{keyword}/{target_count}`
Bir profili okuyun	`twexapi.get_user`	`GET /twitter/{screen_name}/about`
Profil tweet’lerini okuyun	`twexapi.get_user_tweets`	`POST /twitter/{screen_name}/timeline/page`
Trend olan tweetleri okuyun	`twexapi.get_trends`	`GET /twitter/global-trending/tweets`

Bu eklenti takipçileri dışa aktarmaz veya gönderi yayınlamaz. Bu görevler için REST API, CLI veya MCP Sunucusu kullanın.

Önkoşullar

Node.js 18 veya daha yenisi
Ataç CLI (“ataç”)
Kontrol panelinden bir TwexAPI API anahtarı
API anahtarı için bir Ataç gizli referansı

Kurulum

paperclipai plugin install @twexapi-dev/paperclip-plugin-x-api-scraper

Tekrarlanabilir kurulumlara ihtiyaç duyduğunuzda mevcut sürümü sabitleyin:

paperclipai plugin install @twexapi-dev/paperclip-plugin-x-api-scraper --version 0.1.2

npm: @twexapi-dev/paperclip-plugin-x-api-scraper

Kaynak: twexapi-dev/paperclip-plugin-x-api-scraper

Yapılandır

TwexAPI kontrol panelinde bir API anahtarı oluşturun. Bunu bir Paperclip sırrında saklayın ve eklenti yapılandırmasından ona referans verin.

Ayar	Amaç
`apiBaseUrl`	TwexAPI REST uç noktası. Varsayılan olarak “https://api.twexapi.io” olur.
`apiKeySecretRef`	TwexAPI API anahtarı için ataç gizli referansı.
`defaultTimelineCount`	Varsayılan zaman çizelgesi sayfa sayısı 1’den 100’e kadardır.
`defaultUserSearchCount`	Varsayılan kullanıcı arama sayısı 1’den 100’e kadardır.
`defaultTrendCount`	Varsayılan trend sayısı 1’den 100’e kadardır.

Paperclip, arama sırasında API anahtarını çözer ve ’Authorization: Bearer’yı gönderir.

Örnek eklenti yapılandırma şekli:

{
  "apiBaseUrl": "https://api.twexapi.io",
  "apiKeySecretRef": "twexapi/api-key",
  "defaultTimelineCount": 20,
  "defaultUserSearchCount": 10,
  "defaultTrendCount": 20
}

API anahtarlarını hiçbir zaman kaynak kontrolünde kontrol edilen eklenti yapılandırma dosyalarına teslim etmeyin.

Örnek aracı görevleri

Tweet’lerde ara

Temsilciden bir konu hakkındaki son gönderileri aramasını isteyin. Eklenti, ‘twexapi.search_tweets’ aracılığıyla ’POST /twitter/advanced_search/page’i çağırır.

Önerilen istem:

Search X for recent posts about "AI agents lang:en -filter:retweets".
Return tweet IDs, author usernames, text, and created_at for the top 10 results.

Bir profili ve zaman çizelgesini okuyun

Look up @openai, then read the latest timeline page.
Return username, user_id, follower count, and the 5 most recent tweet IDs.

Küresel trend tweet’leri okuyun

Get trending tweets for United States, topic Sports, content NFL.
Summarize the top themes and list 5 representative tweet IDs.

Devir kontrol listesi

Paperclip temsilcileri sonuçları alt sistemlere aktardığında kararlı tanımlayıcıları koruyun.

Veri türü	Mağaza
Tweetler	`tweet_id`, `text`, `author_username`, `created_at`, search query
Profiller	`user_id`, `username`, `name`, follower counts
Trendler	ülke, konu, içerik etiketi, tweet satırları
Sayfalandırma	`next_cursor`, `has_more`, original request parameters

Aynı iş akışında Ataç araçlarını MCP tabanlı aracılarla karıştırırken Agent MCP Handoff konusuna bakın.

Hata işleme

Durum	Aksiyon
`400`	Araç girişini düzeltin. Değiştirmeden tekrar denemeyin.
`401`	Ataç gizli referansını ve API anahtar değerini kontrol edin.
`403`	Hesap erişimini ve kredileri kontrol edin.
`429`	Tekrar denemeden önce geri çekilin.
`5xx`	Sınırlı geri çekilmeyle yeniden deneyin.

Yerel olarak geliştirin

git clone https://github.com/twexapi-dev/paperclip-plugin-x-api-scraper.git
cd paperclip-plugin-x-api-scraper
pnpm install
pnpm check

‘pnpm check’ tür kontrollerini, testleri ve derlemeyi çalıştırır.