instagram · fetch · accountsolari:read
solari fetch instagram account search
Instagram에서 이름으로 계정을 바로 찾습니다.
- MCP 도구
- solari_fetch_instagram_account_search
- CLI
- solari fetch instagram account search
- 권한
- solari:read
- 이용 가능 플랜
- 무료 체험
- Plus
- Pro
- Enterprise
- 크레딧
- 1
개요
이름이나 핸들 일부로 Instagram에서 직접 계정을 찾습니다. catalog account search는 SOLARI가 수집하는 계정만 찾을 수 있습니다. 이 도구는 나머지 계정도 찾고, 그중 이미 수집 중인 계정을 알려 줍니다.
언제 쓰나요 — catalog account search에서 이름으로 찾은 결과가 없거나, 카탈로그에 추가하기 전에 정확한 핸들을 알아야 할 때 쓰세요.
돌려주는 값 — Instagram이 정한 순서대로 최대 50개 계정. 이미 카탈로그에 있는 계정에는 account_id가 붙습니다.
파라미터
- querystring필수
- 이름이나 핸들 일부. @는 붙여도 되고 빼도 됩니다.≤ 100 chars
응답
Response
- querystring
- 검색에 쓴 텍스트. @는 뺀 값입니다.
- itemsobject[]
- 일치한 계정 목록. Instagram이 정한 순서.
- foundinteger
- 돌려받은 계정 수.
- trackedinteger
- account_id가 있는 계정 수.
items[]
- usernamestring
- 핸들. 소문자로 바꾼 값.
- full_namestring | null
- 표시 이름.
- is_verifiedboolean
- 인증 배지 여부.
- is_privateboolean
- 비공개 계정 여부.
- profile_picture_urlstring | null
- 프로필 사진 URL.
- account_iduuid | null
- 이미 수집 중인 계정이면 SOLARI 계정 id. null이면 먼저 fetch instagram account로 추가하세요.
예시
요청
$ solari fetch instagram account search query=innisfree응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.
{
"query": "innisfree",
"items": [
{
"username": "innisfreeofficial",
"full_name": "innisfree official",
"is_verified": true,
"is_private": false,
"profile_picture_url": "https://scontent.cdninstagram.com/v/t51.2885-19/example.jpg",
"account_id": "018cabce-14cc-7544-8890-7811ec33ef74"
},
{
"username": "innisfree_jp",
"full_name": "innisfree Japan",
"is_verified": false,
"is_private": false,
"profile_picture_url": null,
"account_id": null
}
],
"found": 2,
"tracked": 1
}MCP 호출
{
"name": "solari_fetch_instagram_account_search",
"arguments": {
"query": "innisfree"
}
}주의사항
- 아무것도 저장하지 않습니다. 수집하지 않은 계정을 카탈로그에 넣으려면 그 username으로 fetch instagram account를 실행하세요.
- 순서는 Instagram이 정해서 공식 계정이 항상 맨 앞에 오지는 않습니다. is_verified를 확인하세요.
- 여기서는 팔로워 수가 오지 않습니다. 계정이 수집된 뒤 catalog account profile로 확인하세요.