Threads Data Skill

UnifAPI를 통한 공개 Threads(Meta) 데이터의 결정론적 읽기 경로입니다. 이것은 Data Skill입니다: 자체적으로 마케팅 작업을 실행하지 않습니다 — 구체적인 threads/... 오퍼레이션, 응답 형태, 함정을 명시하므로, 어떤 텍스트 우선 리스닝 또는 콘텐츠 워크플로든 매번 표면을 다시 발견하는 대신 하나의 알려진 레시피에서 읽습니다.

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

실시간 증거를 위해 unifapi skill을 사용하세요

공유 unifapi skill(OAuth MCP)을 통해 한 번 연결한 뒤, 아래 오퍼레이션을 호출하세요. 프로필은 **{username}**으로 키가 매겨집니다. 출력이 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 skill의 get_operation을 사용해 정확한 스키마를 읽으세요 — 단, 오퍼레이션은 이 표에서 고르고, 맹목적으로 발견하지 마세요.

워크플로

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

1. 용어를 설정하세요. 브랜드 또는 카테고리 리스닝을 위해 threads/search/recent?q=...(최신)과 threads/search/top?q=... (가장 많이 본)를 함께 호출하세요 — recent는 실시간 대화를 잡고, top은 실제로 퍼진 견해를 잡습니다. next_cursor로 페이징하세요.
2. 핸들을 찾으세요. threads/search/profiles?q=...를 호출해 그 용어에 대한 계정을 표면화하고, 팔로워 규모와 biography를 위해 threads/users/{username}를 호출하세요.
3. 프로필의 활동을 읽으세요. 핸들이 말하고, 답하고, 증폭하는 것을 위해 threads/users/{username}/posts, .../replies, .../reposts를 호출하세요.
4. 견해를 클러스터링하세요. recent와 top 결과 전반의 text를 질문과 의견으로 그룹화하세요; like_count가 어떤 견해가 반향을 일으키는지 순위를 매깁니다.
5. 모든 것을 인용하세요. 모든 인용은 그 게시물이나 프로필에 연결됩니다; billing.records_charged를 보고하세요(또는 billing 메타데이터가 없을 때는 추정하세요).

형태 노트

• ThreadsUser — {username}으로 키가 매겨짐. full_name, biography, follower_count, is_verified, is_private.
• ThreadsPost — code(URL 세그먼트), text, taken_at, like_count, image_url, video_url, user.

함정

• search/recent는 최신이고 search/top은 가장 많이 본 것입니다 — 균형 잡힌 읽기를 위해 둘 다 사용하세요; 어느 하나만으로는 최신성이나 인기도 쪽으로 치우칩니다.
• 게시물은 like_count만 노출합니다 — 게시물 객체에는 답글/리포스트 수가 없습니다. 확산 정도는 리포스트 숫자가 아니라 search/top 순위에서 가늠하세요.
• 비공개 핸들(is_private)은 읽을 수 있는 것을 제한합니다 — 그것을 표면화하세요.
• 낮은 잔액은 리스트 페이지를 조용히 잘라낼 수 있습니다: billing.truncated_due_to_balance를 확인하세요 — true일 때 페이지는 부분적입니다.

Output

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

**"{term}" on Threads** — {N} recent / {N} top posts. Takes: {themes}. Loudest: "{quote}" ({likes} likes, by @handle). Evidence: {post URLs}. Records: ~{N}.

관련 skills

• social-listening-brief (Social Listening), content-opportunity-brief (Content Strategy) — 이 읽기 경로 위에 구축된 리스닝 및 콘텐츠 아이디어 작업.
• unifapi — 공유 데이터 skill: MCP를 연결하고 get_operation으로 정확한 스키마를 조회하세요.