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任意
- 1 ページあたりの投稿の件数。既定値
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 のショートコード。
- 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 か、実際の値ではない可能性があります。