anpm
Get StartedSign in
@yuni-musibe/Instagram Keyword Search AgentPublic

인스타그램 공개 검색 결과 또는 본인 저장 컬렉션을 크롤링하여 원시 지표 기반 시장 리서치 Markdown 리포트를 생성하는 에이전트. 시드 키워드 또는 컬렉션 이름 입력 시 100개 게시물 수집, 해시태그/멘션 자동 확장, 서브토픽 분류, Notion 페이지 업로드까지 단일 명령으로 수행.

2 installsv1.0.0
instagramscrapingresearchmarketingcontent-strategyHybrid
Install command
anpm install instagram-search-agent

Install

Type /analyze-saved in the chat.

Auto-applied rules are also installed.

Commands

CommandsREADME
/analyze-saved인스타그램 본인 저장 컬렉션을 이름으로 지정해 분석. 이름이 없으면 컬렉션 목록을 보여줌.
/instagram인스타그램 리서치 진입점 — 키워드 검색 또는 저장 컬렉션 중 사용자 선택. 명확한 인자가 있으면 자동 라우팅.
/search-instagram인스타그램 공개 검색에서 시드 키워드별 100개 게시물을 크롤링하여 시장 리서치 Markdown 리포트 생성
/setup-instagram-search-agentInstagram Search Agent 의존성 설치 (Playwright + Chromium). anpm install 후 최초 1회 실행.

Portfolio

인스타그램 공개 검색 결과 또는 본인 저장 컬렉션을 크롤링하여 원시 지표 기반 시장 리서치 Markdown 리포트를 생성하는 에이전트. 시드 키워드 또는 컬렉션 이름 입력 시 100개 게시물 수집, 해시태그/멘션 자동 확장, 서브토픽 분류, Notion 페이지 업로드까지 단일 명령으로 수행.

instagramscrapingresearchmarketingcontent-strategy
2 installsv1.0.04/25/2026relay v1.0.11

by

Components

instagram-researcher인스타그램 키워드 리서치 파이프라인 오케스트레이터. 시드 키워드 리스트를 받아 크롤 → 집계 → 분석 → Markdown 리포트 생성을 순차 실행한다. LLM 분석은 이 에이전트가 직접 수행 (외부 API 호출 없음).
aggregate-signals크롤된 raw JSON 에서 숫자 표기를 정규화(만/억/K/M → int)하고, 해시태그·멘션 빈도를 집계하여 LLM 입력용 상위 50개 후보로 축소한다.
classify-subtopics수집된 게시물 집합을 의미 단위 서브토픽 그룹 3~7개로 분류한다. 각 그룹에 한국어 이름·설명·소속 게시물 URL·대표 게시물 3개를 부여하며, 타깃 가설(직군/업종)도 같이 생성한다. 에이전트가 직접 수행 (외부 API 호출 없음).
crawl-instagramPlaywright 와 저장된 세션(storage_state)을 사용하여 인스타그램 공개 검색 결과에서 게시물 최대 100개의 공개 지표를 수집한다. 첫 실행 시 Chrome 팝업으로 사용자 로그인 유도, 이후 세션 자동 재사용. 게시물 타입(릴스/포스트/캐러셀) 판별 후 타입별 가용 필드만 시도하며, 구조적으로 비공개인 필드는 선제 라벨링한다.
extract-keywords정규화된 게시물 집합에서 의미 기반 Top 20 연관 키워드를 추출한다. 해시태그·멘션 빈도 후보 50개를 동의어 묶음과 함께 상위 20개로 선정한다. 에이전트가 직접 수행 (외부 API 호출 없음).
render-report분석 완료된 JSON 을 Notion 복붙 가능한 단일 Markdown 리포트로 렌더링하여 `outputs/YYYY-MM-DD_<slug>.md` 에 저장한다.

Requirements

CLI Tools

python3
npx

Environment Variables

NOTION_TOKEN
Optional

Notion Integration 토큰 (https://www.notion.so/profile/integrations 에서 발급). 형식: ntn_xxx... 또는 secret_xxx...

1. https://www.notion.so/profile/integrations 접속

NOTION_PARENT_PAGE_ID
Optional

리포트가 저장될 부모 Notion 페이지 ID 또는 URL. Integration 을 해당 페이지에 connect 해야 작동.

INSTAGRAM_HANDLE
Optional

본인 인스타그램 핸들 (자동 발견 실패 시 사용). /analyze-saved 에서 본인 저장 컬렉션 접근에 사용.

Runtime

Python >=3.10

Install command

Install command
anpm install instagram-search-agent
yuni-musibeyuni-musibe @yuni-musibe