last30days-skill 딥다이브
— 10개 플랫폼을 2~8분 만에 훑어 리서치 보고서를 뽑아내는 AI 에이전트 스킬

┌─────────────────────────────────────────────────────────────┐ │ 사용자 입력 │ │ /last30days [topic] for [tool] │ └─────────────────────┬───────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Phase 1: Intent Parsing │ │ query_type.py: RECOMMENDATIONS | NEWS | PROMPTING | │ │ COMPARISON | GENERAL │ └─────────────────────┬───────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Phase 2: X Handle Resolution │ │ WebSearch로 @handle 탐색 → --x-handle 플래그 전달 │ └─────────────────────┬───────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Phase 3: 병렬 리서치 실행 │ │ │ │ Reddit X YouTube TikTok Instagram │ │ Bluesky HN Polymarket Truth Social WebSearch │ │ │ │ scripts/last30days.py (5분 타임아웃, foreground 실행) │ └─────────────────────┬───────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Phase 3.5: 데이터 파이프라인 │ │ normalize.py → dedupe.py → score.py → relevance.py │ │ 점수 가중치: 관련성 45% / 최신성 25% / 참여도 30% │ └─────────────────────┬───────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Phase 4: 보충 웹 검색 │ │ WebSearch로 블로그, 튜토리얼, 뉴스 추가 수집 │ └─────────────────────┬───────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Phase 5: 합성 & 출력 │ │ render.py → 쿼리 유형별 포맷팅 │ │ 리서치 보고서 | 프롬프트 팩 | 비교 분석 │ │ 자동 저장: ~/Documents/Last30Days/{topic}.md │ └─────────────────────────────────────────────────────────────┘

# 각 플랫폼 모듈의 공통 패턴
@dataclass
class SearchResult:
    text: str
    author: str
    platform: str
    engagement: int
    timestamp: datetime
    url: str

# reddit.py, bird_x.py, youtube_yt.py 등이 모두 SearchResult 반환
async def search(query: str, days: int = 30) -> list[SearchResult]:
    ...

모든 API 키 → 10개+ 플랫폼 전체 검색 ScrapeCreators만 → Reddit + TikTok + Instagram OpenAI만 → Reddit 전용 모드 API 키 없음 → HN + Polymarket (공개 API)

최종 점수 = 관련성(45%) + 최신성(25%) + 참여도(30%) 관련성 → 양방향 텍스트 유사도(쿼리↔문서 교차 측정) 최신성 → 30일 윈도우 내 시간 감쇠 함수 참여도 → 플랫폼별 정규화된 좋아요/댓글/공유 수 (참여 속도 기준 — 1시간에 100좋아요 > 1주일에 100좋아요)

last30days-skill/ ├── .claude-plugin/ # Claude Code 플러그인 메타데이터 ├── agents/ # Codex, Gemini 등 멀티 에이전트 지원 ├── fixtures/ # 테스트 목 데이터 ├── hooks/ # SessionStart 등 통합 훅 ├── skills/last30days/ # SKILL.md 정의 + 핵심 Python 엔진 │ └── scripts/ │ ├── last30days.py # ⭐ 메인 진입점 │ └── lib/ # 59개 모듈 라이브러리 │ ├── env.py # 환경변수 관리 (TTL 캐시 포함) │ ├── query.py # 쿼리 유형 분류 │ ├── pipeline.py # 수집 파이프라인 │ ├── signals.py # 신호 추출 (구 score.py) │ ├── rerank.py # 결과 재순위 (구 score.py) │ ├── reddit.py # Reddit 수집 │ ├── bird_x.py # X GraphQL 클라이언트 │ ├── youtube_yt.py# YouTube 트랜스크립트 │ ├── bluesky.py # Bluesky AT Protocol │ ├── hackernews.py# HN (무료) │ ├── polymarket.py# 예측시장 (무료) │ ├── normalize.py # 데이터 정규화 │ ├── dedupe.py # 중복 제거 │ ├── relevance.py # 관련성 필터링 │ ├── render.py # 출력 렌더링 │ └── vendor/ │ └── bird-search.mjs # 벤더링된 X GraphQL 클라이언트 ├── tests/ # 455+ 테스트 스위트 ├── SKILL.md # 스킬 워크플로우 정의 ├── CLAUDE.md # Claude Code 컨텍스트 └── gemini-extension.json # Gemini CLI 확장 설정