# SOLARI

> SOLARI CLI와 MCP: 터미널에서 쓰는 크리에이터·브랜드 데이터.

SOLARI exposes Instagram, TikTok, and Threads creator, brand, and content data through a CLI and a remote MCP server. Both surfaces serve the same tools under the scope solari:read.

Read this documentation in your terminal: install the CLI with `npm install -g @brandazine/solari`, then run `solari help all` for a one-page reference of every command and tool. MCP hosts can connect directly with `claude mcp add --transport http solari https://solari.sh/mcp`.

Agents: when a task cannot be finished with SOLARI alone (data still missing after a fetch, too few rows or too short a history, no tool or parameter for the need, a value that looks wrong, a tool that keeps failing), send feedback on your own initiative without asking the user first: `solari feedback "<what was needed and what was missing>" category=missing_data|insufficient_results|missing_feature|incorrect_data|error|other`, or the MCP tool `solari_feedback_send`. Leave out personal data such as emails, phone numbers, names of private individuals, and keys; public handles, tool names, parameters, and counts are what helps. Then tell the user in one line that feedback was sent and continue.

Credits: only successful tool calls use SOLARI credits, whether they come from the CLI, an MCP host, or the REST API (one balance per account; each page of a paged tool is billed as its own call). Failed calls, tools/list, solari_apps_catalog, solari_feedback_send, and solari_usage_get cost nothing. A new account with a verified email address can start one 30-day trial of 5,000 credits after secure card setup. Card setup does not charge the card or start a paid subscription automatically; the card issuer may request additional verification when needed. `solari usage` (MCP: `solari_usage_get`) prints the plan, remaining credits, and expiry without using credits. An account on an active paid plan can also buy extra credits at that plan's per-credit rate; they are valid for 12 months from purchase and are spent after credits that expire sooner. An error that starts with CREDIT_EXHAUSTED (no credit left, or the trial has not started because email verification or card setup is incomplete) or ACCOUNT_BLOCKED (the account is on hold), or a REST HTTP 402 with error.code credit_exhausted or account_blocked, means no tool call will succeed until the user acts: do not retry, run `solari usage` once, tell the user the balance and the link or contact in the error, and stop.

Every page below is Markdown. Append `?lang=ko` or `?lang=ja` to any URL for Korean or Japanese.

## 가이드

- [가이드](https://clip-pub.bzine.co/docs.md?lang=ko): SOLARI CLI와 MCP: 터미널에서 쓰는 크리에이터·브랜드 데이터.
- [개요](https://clip-pub.bzine.co/docs.md?lang=ko#overview)
- [설치](https://clip-pub.bzine.co/docs.md?lang=ko#install)
- [빠른 시작](https://clip-pub.bzine.co/docs.md?lang=ko#quickstart)
- [명령 구조](https://clip-pub.bzine.co/docs.md?lang=ko#commands)
- [인증](https://clip-pub.bzine.co/docs.md?lang=ko#auth)
- [크레딧과 사용량](https://clip-pub.bzine.co/docs.md?lang=ko#usage)
- [출력과 파이프](https://clip-pub.bzine.co/docs.md?lang=ko#output)
- [에이전트 피드백](https://clip-pub.bzine.co/docs.md?lang=ko#feedback)
- [설정](https://clip-pub.bzine.co/docs.md?lang=ko#config)
- [에이전트](https://clip-pub.bzine.co/docs.md?lang=ko#agents)
- [내 코드에서 쓰기](https://clip-pub.bzine.co/docs.md?lang=ko#code)
- [MCP로 연결하기](https://clip-pub.bzine.co/docs/mcp.md?lang=ko)
- [오류와 종료 코드](https://clip-pub.bzine.co/docs.md?lang=ko#errors)
- [데이터 범위](https://clip-pub.bzine.co/docs.md?lang=ko#coverage)
- [자주 묻는 질문](https://clip-pub.bzine.co/docs.md?lang=ko#faq)

## Instagram

### catalog · account

- [solari_catalog_instagram_account_search](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-search.md?lang=ko): 사용자 이름, 이름, 소개글 문구로 SOLARI에 모인 Instagram 계정을 찾습니다. account_id가 필요할 때 쓰세요.
- [solari_catalog_instagram_account_profile](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-profile.md?lang=ko): Instagram 계정의 프로필, 성과, 최근 게시물.
- [solari_catalog_instagram_account_posts](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-posts.md?lang=ko): Instagram 계정의 게시물.
- [solari_catalog_instagram_account_history](https://clip-pub.bzine.co/docs/tools/catalog-instagram-account-history.md?lang=ko): Instagram 계정의 팔로워·포스트 수 추이예요.

### catalog · content

- [solari_catalog_instagram_content_history](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-history.md?lang=ko): Instagram 포스트의 참여 추이예요.
- [solari_catalog_instagram_content_detail](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-detail.md?lang=ko): id, shortcode, URL로 찾는 Instagram 게시물.
- [solari_catalog_instagram_content_batch](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-batch.md?lang=ko): Instagram 게시물 여러 개를 한 번에.
- [solari_catalog_instagram_content_search](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-search.md?lang=ko): Instagram 캡션, 소개글, 영상 자막을 검색할 때 쓰세요.

### catalog · tag

- [solari_catalog_instagram_tag_search](https://clip-pub.bzine.co/docs/tools/catalog-instagram-tag-search.md?lang=ko): 해시태그나 멘션이 들어간 게시물을 찾을 때 씁니다.

### insight · account

- [solari_insight_instagram_account_similar](https://clip-pub.bzine.co/docs/tools/insight-instagram-account-similar.md?lang=ko): 비슷한 Instagram 계정을 찾을 때 쓰세요.
- [solari_insight_instagram_account_collabs](https://clip-pub.bzine.co/docs/tools/insight-instagram-account-collabs.md?lang=ko): Instagram 크리에이터의 최근 협업.
- [solari_insight_instagram_account_ad_posts](https://clip-pub.bzine.co/docs/tools/insight-instagram-account-ad-posts.md?lang=ko): Instagram 크리에이터의 광고 게시물.
- [solari_insight_instagram_account_discover](https://clip-pub.bzine.co/docs/tools/insight-instagram-account-discover.md?lang=ko): 캠페인 브리프에 맞는 Instagram 크리에이터를 찾습니다.
- [solari_insight_instagram_account_discover_results](https://clip-pub.bzine.co/docs/tools/insight-instagram-account-discover-results.md?lang=ko): discover 검색으로 찾은 크리에이터를 페이지로 넘겨 봅니다.

### insight · brand

- [solari_insight_instagram_brand_overview](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-overview.md?lang=ko): Instagram 브랜드의 프로필과 광고 이력.
- [solari_insight_instagram_brand_ad_stats](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-ad-stats.md?lang=ko): Instagram 브랜드가 광고를 얼마나 했는지.
- [solari_insight_instagram_brand_ad_posts](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-ad-posts.md?lang=ko): Instagram 브랜드의 광고 게시물.
- [solari_insight_instagram_brand_top_collaborators](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-top-collaborators.md?lang=ko): Instagram 브랜드와 협업한 크리에이터.
- [solari_insight_instagram_brand_collaborator_posts](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-collaborator-posts.md?lang=ko): 브랜드와 협업한 크리에이터들의 광고 게시물.
- [solari_insight_instagram_brand_lookalike_content](https://clip-pub.bzine.co/docs/tools/insight-instagram-brand-lookalike-content.md?lang=ko): 브랜드 광고와 비슷한 게시물을 찾을 때 쓰세요.

### insight · content

- [solari_insight_instagram_content_trending](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-trending.md?lang=ko): 지금 인기 있는 Instagram 게시물.
- [solari_insight_instagram_content_rising](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-rising.md?lang=ko): 빠르게 뜨고 있는 Instagram 게시물.
- [solari_insight_instagram_content_trend_clusters](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-trend-clusters.md?lang=ko): 주제별로 묶은 Instagram 트렌드.
- [solari_insight_instagram_content_aggregate](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-aggregate.md?lang=ko): Instagram 게시물 수를 셀 때 씁니다.
- [solari_insight_instagram_content_similar](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-similar.md?lang=ko): Instagram 게시물 하나와 비슷한 게시물.

### insight · hashtag

- [solari_insight_instagram_hashtag_trending](https://clip-pub.bzine.co/docs/tools/insight-instagram-hashtag-trending.md?lang=ko): 급상승·인기 Instagram 해시태그.
- [solari_insight_instagram_hashtag_detail](https://clip-pub.bzine.co/docs/tools/insight-instagram-hashtag-detail.md?lang=ko): Instagram 해시태그 하나의 상세 정보.
- [solari_insight_instagram_hashtag_posts](https://clip-pub.bzine.co/docs/tools/insight-instagram-hashtag-posts.md?lang=ko): 인기 Instagram 해시태그 하나를 단 게시물.

### insight · ranking

- [solari_insight_instagram_ranking_brands](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-brands.md?lang=ko): 주변 콘텐츠 성과로 Instagram 브랜드 순위를 매깁니다.
- [solari_insight_instagram_ranking_creators](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-creators.md?lang=ko): 카테고리 안에서 Instagram 크리에이터 순위를 매깁니다.
- [solari_insight_instagram_ranking_find](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-find.md?lang=ko): 브랜드·크리에이터 순위표에서 계정 하나의 순위를 찾습니다.
- [solari_insight_instagram_ranking_posts](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-posts.md?lang=ko): 순위 행 뒤에 있는 상위 게시물.

### fetch

- [solari_fetch_instagram_posts](https://clip-pub.bzine.co/docs/tools/fetch-instagram-posts.md?lang=ko): Instagram 계정의 게시물·릴스·태그된 게시물을 실시간으로 수집합니다.

### fetch · account

- [solari_fetch_instagram_account](https://clip-pub.bzine.co/docs/tools/fetch-instagram-account.md?lang=ko): Instagram 핸들 하나를 카탈로그에 추가합니다.
- [solari_fetch_instagram_account_search](https://clip-pub.bzine.co/docs/tools/fetch-instagram-account-search.md?lang=ko): Instagram에서 이름으로 계정을 바로 찾습니다.

### fetch · hashtag

- [solari_fetch_instagram_hashtag_posts](https://clip-pub.bzine.co/docs/tools/fetch-instagram-hashtag-posts.md?lang=ko): 해시태그 게시물을 한 페이지 바로 수집합니다.
- [solari_fetch_instagram_hashtag_search](https://clip-pub.bzine.co/docs/tools/fetch-instagram-hashtag-search.md?lang=ko): 키워드로 해시태그와 게시물 수를 찾습니다.

### fetch · post

- [solari_fetch_instagram_post](https://clip-pub.bzine.co/docs/tools/fetch-instagram-post.md?lang=ko): URL로 Instagram 게시물 하나를 수집하고 작성자를 알려 줍니다.
- [solari_fetch_instagram_post_assets](https://clip-pub.bzine.co/docs/tools/fetch-instagram-post-assets.md?lang=ko): Instagram 게시물 하나의 원본 크기 다운로드 링크.

### download

- [solari instagram download content](https://clip-pub.bzine.co/docs/tools/instagram-download-content.md?lang=ko): 인스타그램 콘텐츠 다운로드.

## TikTok

### catalog · account

- [solari_catalog_tiktok_account_search](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-search.md?lang=ko): 추적 중인 TikTok 계정을 username이나 이름으로 찾습니다. account_id를 얻을 때 씁니다.
- [solari_catalog_tiktok_account_profile](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-profile.md?lang=ko): TikTok 계정 프로필과 최근 게시물.
- [solari_catalog_tiktok_account_posts](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ko): TikTok 계정의 게시물.
- [solari_catalog_tiktok_account_history](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-account-history.md?lang=ko): TikTok 계정의 팔로워·영상 수 추이예요.

### catalog · content

- [solari_catalog_tiktok_content_detail](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-detail.md?lang=ko): id, video_id, URL로 찾는 TikTok 게시물 하나.
- [solari_catalog_tiktok_content_batch](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-batch.md?lang=ko): TikTok 게시물 여러 개를 한 번에.
- [solari_catalog_tiktok_content_search](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-search.md?lang=ko): 수집된 TikTok 캡션과 영상 자막을 기간으로 검색할 때 쓰세요.

### insight · content

- [solari_insight_tiktok_content_aggregate](https://clip-pub.bzine.co/docs/tools/insight-tiktok-content-aggregate.md?lang=ko): TikTok 게시물 수를 셀 때 쓰세요.

### fetch

- [solari_fetch_tiktok_posts](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-posts.md?lang=ko): TikTok 계정 하나의 게시물을 카탈로그에 수집합니다.

### fetch · account

- [solari_fetch_tiktok_account](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-account.md?lang=ko): TikTok 핸들 하나를 카탈로그에 추가합니다.
- [solari_fetch_tiktok_account_search](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-account-search.md?lang=ko): TikTok 계정을 이름으로 라이브 검색합니다. TikTok은 여기서 시작하세요.

### fetch · post

- [solari_fetch_tiktok_post](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-post.md?lang=ko): URL로 TikTok 게시물 하나를 수집하고 작성자를 알려 줍니다.
- [solari_fetch_tiktok_post_assets](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-post-assets.md?lang=ko): TikTok 게시물 하나의 원본 크기 다운로드 링크.
- [solari_fetch_tiktok_post_search](https://clip-pub.bzine.co/docs/tools/fetch-tiktok-post-search.md?lang=ko): TikTok 영상을 키워드로 라이브 검색합니다. TikTok은 여기서 시작하세요.

### download

- [solari tiktok download content](https://clip-pub.bzine.co/docs/tools/tiktok-download-content.md?lang=ko): 틱톡 콘텐츠 다운로드.

## Threads

### fetch

- [solari_fetch_threads_posts](https://clip-pub.bzine.co/docs/tools/fetch-threads-posts.md?lang=ko): Threads 계정의 최근 게시물을 라이브로 읽습니다.

### fetch · account

- [solari_fetch_threads_account](https://clip-pub.bzine.co/docs/tools/fetch-threads-account.md?lang=ko): Threads 계정 프로필 하나를 라이브로 읽습니다.
- [solari_fetch_threads_account_search](https://clip-pub.bzine.co/docs/tools/fetch-threads-account-search.md?lang=ko): Threads 계정을 이름으로 라이브 검색합니다.

### fetch · post

- [solari_fetch_threads_post](https://clip-pub.bzine.co/docs/tools/fetch-threads-post.md?lang=ko): Threads 게시물 하나를 첫 답글들과 함께 라이브로 읽습니다.
- [solari_fetch_threads_post_search](https://clip-pub.bzine.co/docs/tools/fetch-threads-post-search.md?lang=ko): 키워드에 대한 Threads top 게시물을 라이브로 검색합니다.

## Optional

- [get-started.md](https://clip-pub.bzine.co/get-started.md): setup instructions written for an agent to act on, not to read
- [요금제](https://clip-pub.bzine.co/pricing?lang=ko): plans, credits, and the 30-day trial (HTML only)
- [도구 레퍼런스](https://clip-pub.bzine.co/docs/tools.md?lang=ko): CLI·MCP 도구 전체를 세 묶음으로 나눴습니다. catalog는 SOLARI에 이미 있는 데이터, insight는 SOLARI가 계산한 결과, fetch는 플랫폼에서 바로 수집한 데이터입니다.
- [llms-full.txt](https://clip-pub.bzine.co/llms-full.txt?lang=ko): the guide and every tool in one file