confluence-v2
Pełny dostęp do Confluence Cloud API v2 — zarządzaj stronami, przestrzeniami i dokumentami z poziomu skryptów
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność do bezpośredniego wywoływania wszystkich endpointów Confluence Cloud REST API v2. Obsługuje strony, przestrzenie, foldery, bazy danych, tablice, komentarze, etykiety, zadania i właściwości. Wspiera uwierzytelnianie podstawowe (email + token API) oraz OAuth. Zawiera wbudowany klient HTTP z obsługą paginacji i możliwością migracji z confluence-cli. Idealna dla automatyzacji zarządzania dokumentacją i integracją Confluence z agentami AI.
Jak używać
Przygotuj dane dostępowe do Confluence Cloud. Potrzebujesz adresu URL instancji (np. https://twoja-domena.atlassian.net/wiki), adresu email oraz tokenu API (lub tokenu OAuth). Token API możesz wygenerować w ustawieniach konta Atlassian.
Skonfiguruj zmienne środowiskowe lub plik konfiguracyjny. Ustaw CONFLUENCE_BASE_URL, CONFLUENCE_AUTH_METHOD (basic lub oauth), CONFLUENCE_EMAIL i CONFLUENCE_API_TOKEN (lub CONFLUENCE_OAUTH_TOKEN dla OAuth). Jeśli migrujesz z confluence-cli, umiejętność automatycznie mapuje konfigurację z ~/.confluence-cli/config.json.
Zainstaluj umiejętność w swoim agencie AI lub środowisku MCP. Umiejętność zawiera skrypty Node.js w katalogu scripts/, które działają jako wrappers dla API.
Wykonaj pierwsze zapytanie, aby wyświetlić listę przestrzeni lub stron. Uruchom node scripts/spaces.js list --all lub node scripts/pages.js list --all, aby pobrać wszystkie zasoby. Możesz też pobrać pojedynczy element, np. node scripts/pages.js get 89522178.
Używaj ad-hoc zapytań do endpointów API, jeśli potrzebujesz bardziej zaawansowanych operacji. Skrypt scripts/call.js pozwala na bezpośrednie wywoływanie dowolnego endpointu, np. node scripts/call.js GET /folders/87457793/direct-children.
Integruj umiejętność z agentami AI, aby automatyzować operacje na dokumentach — tworzenie stron, zarządzanie etykietami, dodawanie komentarzy czy aktualizowanie właściwości. Wszystkie grupy endpointów v2 (pages, spaces, folders, databases, whiteboards, comments, labels, tasks, properties) są w pełni obsługiwane.