Hermes Agent için Hermes XAPI

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 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:

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:

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:

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

Mevcut paket sürümü 0.1.6dı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:

export TWEXAPI_KEY="twitterx_..."

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

TWEXAPI_KEY=twitterx_...

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

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:

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.

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.

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.

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.

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.

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.

hermes tools list

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

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:

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:

/xstatus

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

hermes tools list

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

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.