instagram · catalog · accountsolari:read
solari catalog instagram account search
사용자 이름, 이름, 소개글 문구로 SOLARI에 모인 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을 넣으면 그 국가 계정만 남습니다. 꼭 필요할 때만 넣으세요.