atlassian-browser-skills

atlassian-browser-skills

🌐 한국어 (현재 문서) · English

Atlassian MCP·API 토큰이 막혀 있거나 쓸 수 없는 환경에서, 사용자가 이미 로그인해 둔 로컬 브라우저(Safari/Chrome/Edge)를 구동해 LLM 에이전트로 Jira·Confluence를 읽고 쓰는 스킬 모음입니다. API 토큰도, MCP도 필요 없습니다.

설치

Claude Code (플러그인 마켓플레이스 — 권장)

이 저장소는 Claude Code 플러그인 마켓플레이스입니다. Claude Code 안에서:

/plugin marketplace add baekchangjoon/atlassian-browser-skills
/plugin install atlassian-browser-skills@atlassian-browser-skills
/reload-plugins

설치하면 두 스킬(atlassian-browser-macos, atlassian-browser-windows)이 함께 들어오고, OS·작업에 따라 모델이 알아서 호출합니다.

스킬만 직접 설치 (플러그인 없이)

Agent Skills 호환 에이전트(Claude Code/Claude.ai/Cursor/Gemini CLI 등) 어디서나 스킬 폴더만 복사해 쓸 수 있습니다:

git clone https://github.com/baekchangjoon/atlassian-browser-skills
cp -r atlassian-browser-skills/skills/atlassian-browser-macos   ~/.claude/skills/   # macOS
cp -r atlassian-browser-skills/skills/atlassian-browser-windows ~/.claude/skills/   # Windows

스킬이 참조하는 공용 cookbook은 저장소 루트의 references/atlassian-rest-cookbook.md에 있습니다. 스킬만 떼어 쓸 땐 그 경로도 함께 두세요(플러그인 설치 시에는 자동 포함).

업데이트 받기

서드파티 마켓플레이스는 Claude Code에서 자동 업데이트가 기본 꺼져 있어, 새 버전이 릴리스돼도 설치본은 그대로입니다. 둘 중 하나를 선택하세요:

• 수동 업데이트 — 새 버전이 나왔을 때:

  /plugin marketplace update atlassian-browser-skills
  /plugin update atlassian-browser-skills@atlassian-browser-skills
  

• 자동 업데이트 켜기 (1회 설정, 권장): /plugin → Marketplaces 탭 → atlassian-browser-skills 선택 → Enable auto-update. 이후 Claude Code 시작 시 자동으로 최신 버전이 반영됩니다.

아이디어

막혀 있는 것은 외부 접근 경로(Atlassian MCP, 개인 API 토큰)입니다. 정작 사용자가 평소 Jira/Confluence를 여는 브라우저 자체는 막히지 않습니다. 그래서 외부 API 클라이언트를 쓰는 대신, 인증된 브라우저 탭 안에서 동일 출처(same-origin) fetch()를 실행해 Atlassian 자기 자신의 REST API — Jira/Confluence SPA가 내부적으로 쓰는 바로 그 엔드포인트 — 를 호출합니다.

LLM 에이전트
  └─ skill (REST cookbook에서 고른 METHOD + PATH + BODY)
       └─ transport: 로그인된 탭에서 JS 실행
            ├─ macOS:   osascript → Safari / Chrome  (do JavaScript / execute javascript)
            └─ Windows: PowerShell/Python → Chrome DevTools Protocol (Runtime.evaluate)
                 └─ fetch(location.origin + PATH)  ← 세션 쿠키 / SSO 자동 포함
                      └─ Atlassian REST API  →  이슈·페이지 CRUD

장점: API 토큰·MCP·추가 로그인 모두 불필요. 그리고 DOM 스크래핑이 아니라 REST API를 호출하므로 결과가 구조적이고 안정적입니다.

구성

references/atlassian-rest-cookbook.md      # 공용: 모든 엔드포인트 + 페이로드 (Jira/Confluence, Cloud & DC)
skills/
  atlassian-browser-macos/                 # Safari 또는 Chrome, osascript 사용 (실 세션)
    SKILL.md
    scripts/atl_safari.sh                   #   Safari 래퍼: fetch JS 생성 → osascript 실행 → 폴링
    scripts/safari_atl.applescript          #     탭 찾기 + do JavaScript + 폴링
    scripts/atl_chrome_mac.sh               #   Chrome 래퍼 (인터페이스 동일)
    scripts/chrome_atl.applescript          #     탭 찾기 + execute javascript + 폴링
  atlassian-browser-windows/               # Chrome DevTools Protocol
    SKILL.md
    scripts/atl_cdp.ps1                      #   권장 — 무설치 (윈도 내장 PowerShell)
    scripts/atl_cdp.py                       #   선택 대안 — 순수 stdlib Python (pip 불필요)
    scripts/atl_playwright.py                #   대안 — Playwright (pip), CDP attach
    scripts/launch-chrome.ps1               #   디버그 포트로 Chrome/Edge 실행

macOS — Safari / Chrome (osascript)

macOS의 osascript는 이미 실행 중인 Safari/Chrome에 붙어 JS를 실행합니다. 재실행도, 디버그 포트도, 별도 프로파일도 필요 없이 로그인된 실 세션을 그대로 씁니다.

브라우저	스크립트	방식
Safari	atl_safari.sh	do JavaScript
Chrome	atl_chrome_mac.sh	execute javascript

두 방식 모두 promise를 await할 수 없어, 결과를 window 전역에 저장하고 폴링합니다(자동 처리됨).

일회성 설정 후 읽기 테스트