---
title: "Hermes Agent için Hermes XAPI"
description: "Hermes Agent'ta Twexapi destekli X/Twitter otomasyonu için Hermes XAPI eklentisini kurun ve yapılandırın."
---

Hermes XAPI, Twexapi'yi yapılandırılmış bir X/Twitter otomasyon araç seti olarak kullanmaya yönelik yerel Hermes Agent eklentisidir. Twexapi uç nokta kataloğunu, okuma araçlarını, isteğe bağlı eylem araçlarını, eğik çizgi komutlarını ve paketlenmiş Hermes becerisini bir Python eklentisinde paketler.

Bir Hermes Agent iş akışının X/Twitter araması, hesap okumaları, profil aramaları, trendler, takipçiler, yanıtlar, makaleler, DM'ler, tweet gönderme, beğeniler, retweetler, takipler veya hesap durumu kontrolleri gerektirdiğinde Hermes XAPI'yi kullanın.

## Önkoşullar

- Python '3.11' veya daha yenisi
- Eklenti desteğine sahip Hermes Agent
- [Kontrol panelinden](https://twexapi.io/dashboard) bir Twexapi API anahtarı

Hermes eklentileri isteğe bağlıdır. 'Hermes-xapi' araç setinin görünmesini beklemeden önce eklentiyi kurun ve etkinleştirin.

## Kurulum

Herkese açık GitHub deposu için Hermes'in eklenti yükleyicisini kullanın:

```bash
hermes plugins install twexapi-dev/hermes-xapi --enable
```

Hermes, etkileşimli kurulum sırasında 'TWEXAPI_KEY' ister ve onu '~/.hermes/.env' dosyasında saklar. Etkileşimli olmayan yüklemeler istemi atlar. 'Xapi_read'i çağırmadan önce işlem ortamındaki anahtarı veya '~/.hermes/.env'yi ayarlayın.

Paket kurulumunu kendiniz yönettiğinizde, yayınlanan PyPI paketini doğrudan Hermes Python ortamına yükleyin:

```bash
uv pip install --python ~/.hermes/hermes-agent/venv/bin/python hermes-xapi
hermes plugins enable hermes-xapi
```

Hermes Python ortamınız 'pip' içeriyorsa bu yol da geçerlidir:

```bash
~/.hermes/hermes-agent/venv/bin/python -m pip install hermes-xapi
hermes plugins enable hermes-xapi
```

Mevcut paket sürümü `0.1.6`dır. Eklenti adı "hermes-xapi"dir ve Python giriş noktası "hermes-xapi = hermes_xapi"dir.

## Yapılandır

Hermes'i başlatmadan önce Twexapi API anahtarınızı ayarlayın:

```bash
export TWEXAPI_KEY="twitterx_..."
```

Kalıcı Hermes oturumları için anahtarı `~/.hermes/.env` dosyasına ekleyin:

```bash
TWEXAPI_KEY=twitterx_...
```

İsteğe bağlı ortam değişkenleri:

```bash
export TWEXAPI_BASE_URL="https://api.twexapi.io"
export HERMES_XAPI_ENABLE_ACTIONS="false"
```

Katılımsız oturumlar için `HERMES_XAPI_ENABLE_ACTIONS=false` değerini koruyun. Eylemleri yalnızca açık bir onay adımı olan iş akışları için etkinleştirin:

```bash
export HERMES_XAPI_ENABLE_ACTIONS="true"
```

'~/.hermes/.env'yi düzenledikten sonra Hermes zaten çalışıyorsa, etkileşimli bir CLI oturumunda '/reload'ı çalıştırın veya 'xapi_read'i çağırmadan önce ağ geçidini ve cron oturumlarını yeniden başlatın.

## Araçlar

| Araç | Amaç |
| --- | --- |
| `xapi_explore` | Paketlenmiş Twexapi uç nokta kataloğunda API çağrısı yapmadan arama yapın. Her canlı uç nokta çağrısından önce bunu kullanın. |
| `xapi_read` | 'TWEXAPI_KEY' yapılandırıldıktan sonra katalogda listelenen salt okunur uç noktaları çağırın. |
| `xapi_action` | Özel, ücretli toplu veya yazma benzeri uç noktaları yalnızca "HERMES_XAPI_ENABLE_ACTIONS=true" olduğunda çağırın. |

Aracının bir uç noktayı çağırmadan önce doğru yöntemi, yolu, parametreleri ve yanıt şeklini keşfedebilmesi için "xapi_explore" ile başlayın.

```txt
Use xapi_explore to find the endpoint for user lookup, then call xapi_read for @username.
```

## İş akışı aktarımları

Önce "xapi_explore"u kullanın, ardından genel okumalar için "xapi_read"i veya durum oluşturan veya durumu değiştiren onaylı işler için "xapi_action"ı seçin.

### Tweet arama okuma

'xapi_read'i '/twitter/advanced_search/page' veya katalogda listelenen başka bir arama uç noktasıyla birlikte kullanın. Mevcut olduğunda tweet kimliklerini, metni, yazar kullanıcı adlarını, zaman damgalarını, etkileşim ölçümlerini, `has_more` ve "next_cursor"u döndürün.

```txt
Use xapi_explore to find tweet search endpoints.
Use xapi_read for /twitter/advanced_search/page with searchTerms ["AI agents"] and maxItems 25.
Return tweet_id, text, author_username, created_at, and engagement counts.
```

### Trend araştırması

Trend olan rotaları bulmak için "xapi_explore"u kullanın, ardından ülke, konu, içerik veya trend uç noktaları için "xapi_read"i çağırın.

```txt
Use xapi_explore to find X/Twitter trend endpoints.
Use xapi_read to return current trends for worldwide.
Mevcut olduğunda `country`, `topic`, `content`, `rank`, `has_more` ve `next_cursor` alanlarını koruyun.
```

### Takipçi dışa aktarma

Takipçi uç noktalarını bulmak için "xapi_explore" kullanın. Sınırlı okumalar için "xapi_read"i ve yalnızca katalog rotayı özel, ücretli toplu veya eylem benzeri olarak işaretlediğinde "xapi_action"ı kullanın.

```txt
Use xapi_explore to find follower export endpoints.
Fetch followers for @username with a bounded count.
If the response returns a task_id, store it and poll the documented status and next-page routes.
```

### Kontrollü yazma eylemi

'Xapi_action'ı yalnızca onaylandıktan sonra kullanın. Katılımsız oturumlarda eylem araçlarını devre dışı bırakın.

```txt
Use xapi_explore with include_actions true to find tweet posting endpoints.
Draft the exact request body.
Ask for explicit approval.
Only after approval, call xapi_action.
Return tweet_id, status, charged_credits, and any write action ID.
```

## Çalışma zamanı teşhisi

Komut dosyası oluşturulabilir kontroller için 'hermes araçları listesini' kullanın. Çıplak "hermes araçları" etkileşimli araç kullanıcı arayüzünü açar ve bir TTY gerektirir.

```bash
hermes tools list
```

Eklenti etkinleştirildikten sonra mutasyona uğramayan tek seferlik bir araştırma çalıştırın:

```bash
hermes -z "Use xapi_explore, then read /twitter/elonmusk/about. Do not call xapi_action." --toolsets hermes-xapi
```

Beklenen davranış:

- 'xapi_explore' katalog uç noktalarını API anahtarı olmadan inceleyebilir.
- 'TWEXAPI_KEY' olmadan, mutasyona uğramayan bir Hermes araştırması yalnızca 'xapi_explore'u açığa çıkarır.
- 'TWEXAPI_KEY' yapılandırıldıktan ve CLI yeniden yüklendikten veya ağ geçidi veya cron işlemi yeniden başlatıldıktan sonra, 'xapi_read', '/twitter/elonmusk/about' okuyabilir.
- 'Xapi_action', 'HERMES_XAPI_ENABLE_ACTIONS=true' olmadığı sürece gizli veya devre dışı kalır.
- Hermes eklentisi komut kaydında `/xstatus` ve `/xtrends` görünür.

Hermes'in tek seferlik istemleri, etkileşimli bir eğik çizgi komutu olarak `/xstatus'u göndermez. Etkin bir CLI, TUI, Masaüstü veya ağ geçidi oturumunda eğik çizgi komutlarını doğrulayın ve araç çağrısı araştırmaları için "hermes -z"yi kullanın.

Etkileşimli olmayan yüklemelerde kimlik bilgileri istenemez; İşlem ortamında 'TWEXAPI_KEY' veya '~/.hermes/.env' ayarını yapın.

## Slash komutları

| Komut | Amaç |
| --- | --- |
| `/xstatus` | Aktif bir Hermes oturumunda Twexapi hesabını, aboneliğini ve kullanım durumunu gösterin. |
| `/xtrends` | Eklenti komut kaydındaki mevcut X/Twitter trendlerini gösterin. |

## Güvenlik modeli

Hermes XAPI, ortam değişkenlerinden kimlik doğrulamasını okur ve bunu istek zamanında enjekte eder. Model, API anahtarını bir araç bağımsız değişkeni olarak almaz.

Eklenti, çerez/belirteç yardımcı rotalarını, katılım-satın alma rotalarını, otomatik çerez gönderimini, profil mutasyonunu, liste oluşturmayı ve temsilci kataloğundan duygu rotalarını engeller. Özel okumalar, ücretli toplu uç noktalar ve yazma benzeri uç noktalar, 'HERMES_XAPI_ENABLE_ACTIONS=true' olmadığı sürece gizli kalan 'xapi_action'dan geçer.

Gözetimsiz işler için eylem araçlarını devre dışı bırakın ve yalnızca "xapi_explore" artı "xapi_read" kullanın.

## API kapsamı

Hermes XAPI, OpenAPI sözleşmesinden oluşturulan 76 aracı tarafından çağrılabilir Twexapi uç noktası içerir.

| Alan | Yaygın kullanımlar |
| --- | --- |
| Herkese açık okumalar | Tweet arama, tweet arama, kullanıcı arama, zaman çizelgeleri, makaleler, yanıtlar ve trendler. |
| Özel okumalar | Hesap durumu, bakiye ve hesap düzeyinde kontroller. |
| İlişki verileri | Takipçiler, takip edenler, retweetleyenler, alıntı tweetleri ve favoriler. |
| Topluluklar ve listeler | Topluluk meta verileri, üyeler, tweet'ler, liste tweet'leri, aboneler ve üyeler. |
| Eylemler | Etkinleştirildiğinde tweet atın, yanıtlayın, beğenin, retweetleyin, takip edin, DM, medya, yer imleri, makaleler ve hesap işlemleri. |

## Yerel geliştirme

Yerel eklenti geliştirme için, paket kataloğunu Twexapi OpenAPI sözleşmesinden yeniden oluşturun:

```bash
python scripts/build_catalog.py ../twexapi/openapi.yaml
```

Twexapi OpenAPI dosyası değiştikten sonra bu komutu 'hermes-xapi' deposundan çalıştırın.

## Doğrulama

'TWEXAPI_KEY'i kurduktan, etkinleştirdikten ve ayarladıktan sonra şunu çalıştırın:

```txt
/xstatus
```

Komut dosyası oluşturulabilir teşhisler için eklenti araç setini listeleyin:

```bash
hermes tools list
```

Ardından bir okuma iş akışını test edin:

```txt
Use xapi_explore to find X/Twitter trends, then use xapi_read to return current trends.
```

Eylem iş akışları için "xapi_action"ı etkinleştirmeden önce açık bir taslak ve onay adımı isteyin.

## Sorun giderme

| Sorun | Fix |
| --- | --- |
| Araçlar eksik | 'Hermes eklentileri etkinleştir hermes-xapi'yi çalıştırın, ardından 'hermes araçları listesinde' 'hermes-xapi'nin göründüğünü doğrulayın. |
| Kimlik doğrulama başarısız | 'TWEXAPI_KEY'in Hermes'i başlatan ortamda dışa aktarıldığını veya '~/.hermes/.env'de saklandığını doğrulayın. |
| Ortam değişiklikleri alınamadı | Etkileşimli CLI'de `/reload` komutunu çalıştırın veya ağ geçidini ve cron oturumlarını yeniden başlatın. |
| Eylem aracı gizlendi | Yalnızca onaylı eylem iş akışları için "HERMES_XAPI_ENABLE_ACTIONS=true" ayarını yapın. |
| Uç nokta eksik | Kataloğu yerel geliştirmede mevcut Twexapi OpenAPI dosyasından yeniden oluşturun. |
| Riskli yazıyor | `HERMES_XAPI_ENABLE_ACTIONS=false' değerini koruyun ve yalnızca okuma araçlarını kullanın. |

## XApiClaw ile İlişki

XApiClaw, OpenClaw yerel npm eklentisidir. Hermes XAPI, Hermes'in yerel Python eklentisidir. Her ikisi de aynı Twexapi API sözleşmesini kullanıyor ve canlı uç nokta çağrılarından önce aracı açısından güvenli katalog keşfini kullanıma sunuyor.

## Referanslar

- [Hermes XAPI GitHub deposu](https://github.com/twexapi-dev/hermes-xapi)
- [PyPI'de Hermes XAPI](https://pypi.org/project/hermes-xapi/)
- [Hermes Temsilcisi](https://github.com/NousResearch/hermes-agent)
- Kenar çubuğundaki API Referansı
- [MCP Sunucusu](/mcp/overview)