farcaster-skill
Post, read, search, and engage on Farcaster via the Neynar API. Use when an agent needs to: (1) post casts with text, embeds, or in channels, (2) reply to or thread casts, (3) read a user's feed or a channel feed, (4) search casts by keyword, (5) look up user profiles by
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Post, read, search, and engage on Farcaster via the Neynar API. Use when an agent needs to: (1) post casts with text, embeds, or in channels, (2) reply to or thread casts, (3) read a user's feed or a channel feed, (4) search casts by keyword, (5) look up user profiles by username or FID, (6) like or recast, (7) delete casts, (8) list or search channels. Pure bash+curl+jq — zero npm dependencies.
How to use
Przygotuj klucz API Neynar i UUID signer. Ustaw zmienne środowiskowe: export NEYNAR_API_KEY="twój-klucz" i export NEYNAR_SIGNER_UUID="twój-uuid". Alternatywnie umieść dane w pliku JSON i załaduj je komendą eval $(jq -r '"export NEYNAR_API_KEY=(.apiKey)\nexport NEYNAR_SIGNER_UUID=(.signerUuid)"' /ścieżka/do/neynar.json).
Aby opublikować prosty post, uruchom scripts/fc_cast.sh --text "Twoja wiadomość". Możesz dodać osadzenia (maksymalnie 2) flagą --embed "https://url.do/zasobu", wybrać kanał flagą --channel "nazwa" lub odpowiedzieć na istniejący cast flagą --parent "hash-casta".
Do czytania postów użytkownika uruchom scripts/fc_feed.sh --fid NUMER (po ID użytkownika) lub scripts/fc_feed.sh --username "nazwa" (po nazwie użytkownika). Dodaj --limit LICZBA, aby ograniczyć ilość wyników.
Aby przeglądać kanał, użyj scripts/fc_feed.sh --channel "nazwa-kanału" --limit LICZBA. Komenda zwraca posty z wybranego kanału w formacie JSON.
Wyszukuj posty po słowach kluczowych, czytaj profile użytkowników, lubisz, udostępniaj lub usuwaj casts — wszystkie te operacje są dostępne poprzez odpowiednie skrypty w katalogu scripts/. Każdy skrypt zwraca wynik w formacie JSON z polem success i dodatkowymi danymi (np. hash nowego posta).