Instagram Data Skill

UnifAPI를 통한 공개 Instagram 데이터의 결정론적 읽기 경로. 이것은 데이터 스킬입니다: 자체적으로 마케팅 작업을 실행하지 않습니다 — 구체적인 instagram/... 작업, 응답 형태, 함정을 명시하여, 어떤 크리에이터 우선 워크플로(후보 선정, 청중 적합성, 가격 책정 맥락)든 매번 표면을 다시 발견하는 대신 하나의 알려진 레시피에서 읽도록 합니다.

읽기 전용 — 손이 아니라 눈. 공개 Instagram 데이터를 리서치하고 인용된 record를 반환합니다; 절대 게시하거나, 댓글을 달거나, DM을 보내지 않으며, UnifAPI는 Instagram 자격 증명을 절대 보유하지 않습니다.

실시간 근거를 위해 unifapi 스킬을 사용하세요

공유 unifapi 스킬을 통해 한 번 연결(OAuth MCP)한 다음, 아래 작업들을 호출하세요. 프로필은 **{username}**으로, 게시물은 {shortcode}(URL 세그먼트)로 키가 매겨집니다 — instagram/resolve/*는 필요할 때 username↔user-id와 shortcode↔media-id 사이를 매핑합니다. 출력이 record 비용을 명시할 수 있도록 모든 billing 메타데이터를 보관하세요.

응답 계약

단일 엔티티 엔드포인트는 객체를 data에 반환합니다:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

리스트 엔드포인트는 배열을 data에 더하여 pagination을 반환합니다:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

pagination.has_more가 true일 때, pagination.next_cursor를 다음 요청의 cursor로 전달하세요. 비용을 보고할 때는 항상 billing을 보존하세요.

핵심 작업

여기 나열되지 않은 필드가 필요한가요? 호출하기 전에 unifapi 스킬의 get_operation을 사용해 정확한 스키마를 읽으세요 — 하지만 작업은 이 표에서 고르고, 맹목적으로 발견하지 마세요.

워크플로

결정론적 레시피입니다. 작업에 맞는 것을 고르세요; 각각이 정확히 무엇을 호출할지 명시합니다.

1. 프로필 해석하기. instagram/users/{username}를 호출해 follower_count, media_count, is_private, is_verified를 얻으세요.
2. 콘텐츠와 참여도 읽기. instagram/users/{username}/posts와 .../reels를 호출하세요; 각 InstagramPost는 like_count, comment_count, 그리고 동영상의 경우 play_count/view_count를 담고 있습니다 — 그리고 스폰서 콘텐츠를 표시하는 is_paid_partnership도. next_cursor로 페이지를 넘기세요.
3. 반응 읽기. 상위 게시물의 감정을 위해 instagram/posts/{shortcode}/comments (그리고 답글 엔드포인트)를 호출하세요.
4. 새 핸들 발견하기. instagram/search?q=..., instagram/explore, 또는 instagram/locations/{id}/posts를 호출한 다음, 드러난 핸들을 해석하고 1단계로 루프하세요.
5. 네트워크나 청중 매핑하기. 리치 작업을 위해 instagram/users/{username}/followers, .../following, 또는 .../tagged-posts(누가 그들을 피처링하는지)를 호출하세요.
6. 모든 것을 인용. 모든 수치는 그것이 나온 게시물이나 프로필로 거슬러 올라갑니다; billing.records_charged를 보고하세요(billing 메타데이터가 없으면 추정).

형태 노트

• InstagramUser — {username}으로 키가 매겨집니다. follower_count, following_count, media_count, is_verified, is_private.
• InstagramPost — {shortcode}로 키가 매겨집니다. caption, like_count, comment_count, play_count, view_count, taken_at, media_type, is_paid_partnership, user, location, carousel.
• InstagramComment — text, like_count, child_comment_count.
• InstagramLocation — name, lat, lng, media_count.

함정

• 프로필은 {username}으로, 게시물은 {shortcode}로 키가 매겨집니다 — 둘 다 공개 IG URL에서 읽습니다. 숫자 user-id나 media-id가 필요할 때만 instagram/resolve/*를 사용하세요.
• 비공개 계정(is_private)은 프로필을 노출하지만 미디어를 제한합니다 — 이를 드러내고, 얇은 커버리지를 가리지 마세요.
• is_paid_partnership는 공개된 스폰서 게시물을 표시합니다 — 가격 책정과 브랜드 안전성에 유용한 근거이니, 보고하세요.
• 잔액이 낮으면 리스트 페이지가 조용히 잘릴 수 있습니다: billing.truncated_due_to_balance를 확인하세요 — true일 때 페이지는 부분적입니다.

출력

호출 워크플로가 필요로 하는 record를, 각각을 그 게시물이나 프로필에 인용하여 반환하고, 한 줄짜리 비용 노트(records_charged)를 더하세요. 이 스킬이 직접 사용될 때는, 간결한 크리에이터 요약이 기본값입니다:

**@handle** — {followers} followers, {media} posts, verified {yes/no}. Recent posts: avg {likes} likes / {comments} comments. Paid partnerships: {N}. Evidence: {post URLs}. Records: ~{N}.

관련 스킬

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — 이 읽기 경로 위에서 Instagram 크리에이터의 가격을 책정하고 검증합니다.
• unifapi — 공유 데이터 스킬: MCP를 연결하고 get_operation으로 정확한 스키마를 조회합니다.