octolens

Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND/OR logic, date ranges, follower counts, and bookmarks.

1. Upewnij się, że masz zainstalowany Node.js 18 lub nowszy oraz dostęp do internetu. Umiejętność wymaga tych warunków do działania.

2. Uzyskaj klucz API od Octolens i przechowuj go w bezpiecznym miejscu. Zawsze poproś użytkownika o podanie klucza API przed wykonaniem jakichkolwiek zapytań — będzie on używany w nagłówku Authorization jako Bearer token.

3. Aby pobrać wzmianki o marce, użyj głównego endpointu POST /mentions. Określ słowa kluczowe, które chcesz śledzić, oraz opcjonalne filtry: platformy źródłowe (Twitter, Reddit, GitHub, LinkedIn, YouTube, HackerNews, DevTO, StackOverflow, Bluesky, newslettery, podcasty), zakres dat, minimalną liczbę obserwujących autora i typ sentymentu.

4. Wykorzystaj zaawansowane opcje filtrowania: ustaw limit wyników (1-100, domyślnie 20), dodaj logikę AND/OR do łączenia warunków, filtruj po zaangażowaniu społecznym i zastosuj kursory do paginacji dla większych zbiorów danych.

5. Monitoruj limity zapytań — API pozwala na 500 żądań na godzinę. Sprawdzaj nagłówki X-RateLimit-* w odpowiedziach, aby śledzić bieżące użycie.

6. Dla powtarzających się analiz zapisz swoje ulubione filtry jako widoki, a następnie pobieraj je za pomocą endpointu listy dostępnych słów kluczowych i zapisanych widoków.