instagram · catalog · accountsolari:read
solari catalog instagram account search
収集済みの Instagram アカウントを、ユーザー名・名前・プロフィール文の語句で探します。account_id を調べるときに使います。
- MCP ツール
- solari_catalog_instagram_account_search
- CLI
- solari catalog instagram account search
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
SOLARI が収集した Instagram アカウントを、ユーザー名・表示名・プロフィール文の語句で検索します。Instagram 本体の検索ではありません。ここで得た account_id を、ほかの Instagram ツールに渡します。
どんなときに使うか — 名前やユーザー名はわかっていて、account_id がまだないとき。
返される内容 — 条件に合うアカウント。近いものから順に並びます。
パラメータ
- querystring必須
- ユーザー名か表示名。query_type=bio のときはプロフィール文の語句。
- query_typeenum任意
- 検索する対象。ユーザー名・表示名・プロフィール文、またはそのすべて（auto）。既定値
"auto"値autousernamefull_namebio - brands_onlyboolean任意
- 既知のブランドアカウントだけを返します。ブランドを調べるときはオンにしてください。既定値
false - limitinteger任意
- 返すアカウントの件数。既定値
81–50 - regionstring任意
- KR や JP などの国コード。指定しなければ全地域を検索します。≤ 8 chars
レスポンス
Response
- foundboolean
- 一致したアカウントがあるかどうか。
- itemsobject[]
- 一致したアカウント。近いものから順に並びます。
items[]
- account_iduuid
- ほかの Instagram ツールに渡す account_id。
- usernamestring
- Instagram のユーザー名。
- full_namestring
- 表示名。
- biographystring
- プロフィール文。
- follower_countinteger
- フォロワー数。
- regionstring
- 地域コード。
- is_verifiedboolean
- 認証バッジ。
- profile_pic_urlstring
- プロフィール画像の URL。
例
リクエスト
$ solari catalog instagram account search query=oliveyoung brands_only=true limit=5レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"found": true,
"items": [
{
"account_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
"username": "oliveyoung_official",
"full_name": "올리브영 OLIVE YOUNG",
"biography": "ALL LIVE YOUNG 🫒\nALL LIVE BETTER @olivebetter.official",
"follower_count": 1199628,
"region": "KR",
"is_verified": true,
"profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_official/profile-picture"
},
{
"account_id": "018dc63c-31b5-740f-bde0-2c00931385e1",
"username": "oliveyoung_global",
"full_name": "OLIVE YOUNG Global",
"biography": "Korea's No.1 Health & Beauty Store\n✈️ FREE SHIPPING on orders over $60",
"follower_count": 535949,
"region": "KR",
"is_verified": true,
"profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_global/profile-picture"
},
{
"account_id": "018cabcf-e60e-70af-95eb-eff777ce5195",
"username": "oliveyoung_magazine",
"full_name": "올리브영 매거진",
"biography": "내 일상과 가까운 뷰티 매거진",
"follower_count": 142316,
"region": "KR",
"is_verified": false,
"profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_magazine/profile-picture"
},
"… 2 more"
]
}MCP で呼び出す場合
{
"name": "solari_catalog_instagram_account_search",
"arguments": {
"query": "oliveyoung",
"brands_only": true,
"limit": 5
}
}注意点
- 名前がユーザー名か表示名に含まれている必要があります。ニックネームや略称では、たいてい見つかりません。
- ブランドを探すときは brands_only=true を指定すると、ファンアカウントが除かれます。
- region を指定すると、その国のアカウントだけに絞り込みます。必要なとき以外は指定しないでください。