---
title: "Paperclip"
description: "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](https://paperclip.ai) 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](/api-reference/overview), [CLI](/sdks/cli) veya [MCP Sunucusu](/mcp/overview) kullanın.

## Önkoşullar

- Node.js 18 veya daha yenisi
- Ataç CLI ("ataç")
- [Kontrol panelinden](https://twexapi.io/dashboard) bir TwexAPI API anahtarı
- API anahtarı için bir Ataç gizli referansı

## Kurulum

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

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

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

npm: [@twexapi-dev/paperclip-plugin-x-api-scraper](https://www.npmjs.com/package/@twexapi-dev/paperclip-plugin-x-api-scraper)

Kaynak: [twexapi-dev/paperclip-plugin-x-api-scraper](https://github.com/twexapi-dev/paperclip-plugin-x-api-scraper)

## Yapılandır

[TwexAPI kontrol panelinde](https://twexapi.io/dashboard) 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:

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

```text
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

```text
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

```text
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](/mcp/agent-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

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

## İlgili kılavuzlar

* [MCP Sunucusu](/mcp/overview)
* [CLI](/sdks/cli)
* [TypeScript SDK'sı](/sdks/typescript)
* [OpenAPI şeması](https://docs.twexapi.io/openapi.json)
* [Kaynak deposu](https://github.com/twexapi-dev/paperclip-plugin-x-api-scraper)