instagram · catalog · accountsolari:readサインイン済みの SOLARI アカウントであれば利用できます。
solari catalog instagram account search
集めた Instagram アカウントをユーザー名、名前、Bio の語句から探します。account_id を取るときに使えます。
- MCP ツール
- solari_catalog_instagram_account_search
- CLI
- solari catalog instagram account search
- アクセス権
- solari:readサインイン済みの SOLARI アカウントであれば利用できます。サインイン済みの SOLARI アカウントであれば利用できます。
- Required plan
- Free
- Credit
- 0
概要
SOLARI が集めた Instagram アカウントのカタログから、ユーザー名、表示名、またはプロフィール Bio の語句で探します。Instagram 本体の検索ではありません。ここで得た account_id は、ほかの Instagram ツールにそのまま渡せます。
どんなときに使うか — 名前やユーザー名だけで、まだ account_id がないときに使います。
何が返るか — 一致したアカウントの一覧です。いちばん近い結果が先頭に来ます。
パラメータ
- querystring必須
- ユーザー名、表示名、または query_type=bio のときはプロフィール Bio の語句。
- query_typeenum任意
- どこを見るか。ユーザー名、表示名、Bio、またはその全部 (auto)。既定値
"auto"値autousernamefull_namebio - brands_onlyboolean任意
- 既知のブランドアカウントだけにします。ブランドを探すときにオンにします。既定値
false - limitinteger任意
- 返すアカウントの数。≥ 1
- regionstring任意
- KR や JP などの国コード。空なら全体を探します。≤ 8 chars
レスポンス
Response
- foundboolean
- 一致したアカウントがあるか。
- itemsobject[]
- 一致したアカウントです。いちばん近い結果が先頭です。
items[]
- account_iduuid
- ほかの Instagram ツールに渡す account_id。
- usernamestring
- Instagram のユーザー名。
- full_namestring
- 表示名。
- biographystring
- プロフィール Bio。
- 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 を付けると指定した国だけになります。特定の国でなければ空のままにしてください。