instagram · catalog · contentsolari:read
solari catalog instagram content search
Instagram 캡션, 소개글, 영상 자막을 검색할 때 쓰세요.
- MCP 도구
- solari_catalog_instagram_content_search
- CLI
- solari catalog instagram content search
- 권한
- solari:read
- 이용 가능 플랜
- 무료 체험
- Plus
- Pro
- Enterprise
- 크레딧
- 1
개요
KR, JP, US, TW에서 수집한 Instagram 게시물을 키워드로 검색합니다. 대략 최근 6개월치가 대상입니다.
언제 쓰나요 — 주제에 관한 게시물이 필요할 때. 개수가 필요하면 content aggregate 도구를 쓰세요.
돌려주는 값 — 관련도 순으로 정렬한 게시물. 일치한 글자는 강조 표시됩니다.
파라미터
- querystring필수
- 검색할 단어.
- regionenum선택
- KR, JP, US, TW 중 하나.기본값
"KR"값KRJPUSTW - limitinteger선택
- 한 페이지에 가져올 게시물 수.기본값
201–100 - offsetinteger선택
- 건너뛸 게시물 수.기본값
0≥ 0 - sincestring선택
- 이 날짜(UTC, YYYY-MM-DD)부터 올라온 게시물만 가져옵니다.pattern ^\d{4}-\d{2}-\d{2}$
- untilstring선택
- 이 날짜(UTC, YYYY-MM-DD)까지 올라온 게시물만 가져옵니다.pattern ^\d{4}-\d{2}-\d{2}$
응답
Response
- query / regionstring
- 적용한 검색어와 지역.
- totalinteger
- 전체 일치 수. 10,000까지는 정확하고, 그 뒤로는 10,000에서 멈춥니다.
- took_msinteger
- 검색에 걸린 시간.
- itemsobject[]
- 검색 결과. 점수가 높은 순서입니다.
items[]
- post_iduuid
- SOLARI 게시물 id.
- slugstring
- Instagram shortcode.
- account_id / author_id / usernamestring
- 게시물을 올린 계정.
- captionstring
- 캡션.
- user_biostring
- 작성자 소개글. 검색 대상 텍스트에 들어갑니다.
- transcription_textstring | null
- 영상 음성 자막.
- posted_attimestamp
- 게시 시각(UTC).
- like_count / comment_countinteger
- 참여 지표.
- follower_countinteger
- 작성자 팔로워 수.
- scorenumber
- 관련도 점수. 같은 응답 안에서만 비교할 수 있습니다.
- highlightobject
- 필드별 일치 부분. caption, user_bio, transcription_text.
- is_videoboolean
- 영상 게시물인지 여부.
- assetsobject[]
- 미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
- assets[].asset_urlstring | null
- 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null입니다.
예시
요청
$ solari catalog instagram content search query="이니스프리 그린티" limit=3응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.
{
"query": "이니스프리 그린티",
"region": "KR",
"total": 10000,
"took_ms": 1586,
"items": [
{
"post_id": "019f12d8-3e72-78e9-b7e5-39293bc56f23",
"author_id": "019f12d8-3e0f-7c74-afc6-e14405bd1523",
"username": "hanydiary",
"caption": "[이니스프리에디터 4기 1-2 : 그린티 PDRN 아이&립 세럼] #이니스프리 #그린티PDRN 💚 자세한 포스팅은 프로필 링크 참고해주세요 :)",
"user_bio": "대외활동 | 휴학생 | 취준일기 🪽과 학생회 2년 연임 🪽이니스프리 대학생 에디터 3기 / 4기",
"transcription_text": null,
"posted_at": "2026-02-16T05:44:45Z",
"like_count": 3,
"comment_count": 3,
"follower_count": 972,
"score": 140.43787,
"slug": "DUzrl1UkoJb",
"highlight": {
"caption": [
"[<mark>이니스프리</mark>에디터 4기 1-2 : <mark>그린티</mark> PDRN 아이&립 세럼] #이니스프리 #그린티PDRN 💚 자세한 포스팅은 프로필 링크 참고해주세요 :)"
],
"user_bio": [
"대외활동 | 휴학생 | 취준일기 🪽과 학생회 2년 연임 🪽<mark>이니스프리</mark> 대학생 에디터 3기 / 4기"
],
"transcription_text": []
},
"is_video": false,
"media_url": null,
"thumbnail_url": null,
"account_id": "019f12d8-3e0f-7c74-afc6-e14405bd1523"
},
"… 2 more"
]
}MCP 호출
{
"name": "solari_catalog_instagram_content_search",
"arguments": {
"query": "이니스프리 그린티",
"limit": 3
}
}주의사항
- since를 약 6개월보다 이전으로 넣으면 결과가 없습니다.
- total은 10,000까지만 셉니다.
- likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.