instagram · fetchsolari:read
solari fetch instagram account
Instagram 핸들 하나를 카탈로그에 추가합니다.
- MCP 도구
- solari_fetch_instagram_account
- CLI
- solari fetch instagram account
- 권한
- solari:read
- 이용 가능 플랜
- 무료 체험
- Plus
- Pro
- Enterprise
- 크레딧
- 1
개요
정확한 username으로 Instagram 계정 하나를 SOLARI 카탈로그에 추가합니다. 검색 기능이 아닙니다. 하루 안에 수집한 계정이면 새로 수집하지 않고, 그보다 오래됐으면 지금 다시 수집합니다. 태그나 언급으로 이름만 알려진 핸들이면 지금 수집합니다.
언제 쓰나요 — 정확한 핸들을 알고 있는데 카탈로그 검색에 나오지 않을 때 쓰세요.
돌려주는 값 — 추가됐는지 여부, account_id, 그 계정을 읽는 카탈로그 명령.
파라미터
- usernamestring필수
- Instagram username.≤ 64 chars
응답
Response
- ingestedboolean
- 이번 호출에서 바로 수집했으면 true.
- already_trackedboolean
- 이미 수집돼 있었으면 true.
- fetched_on_demandboolean
- ingested와 같은 값.
- account_iduuid
- 추가된 계정.
- usernamestring
- 찾은 핸들.
- notestring
- 다음에 일어날 일.
- nextstring
- 결과를 읽는 카탈로그 명령.
- refreshedboolean
- 하루 넘게 지난 저장본을 지금 다시 수집했으면 true.
- collected_attimestamp
- 저장된 프로필을 수집한 시각(UTC).
예시
요청
$ solari fetch instagram account username=innisfreeofficial응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.
{
"ingested": false,
"already_tracked": true,
"fetched_on_demand": false,
"account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
"username": "innisfreeofficial",
"note": "Already in the SOLARI catalog. Nothing was scraped.",
"next": "solari catalog instagram account profile username=innisfreeofficial"
}MCP 호출
{
"name": "solari_fetch_instagram_account",
"arguments": {
"username": "innisfreeofficial"
}
}주의사항
- 이름을 검색하는 데 쓰지 마세요. 먼저 catalog account search를 쓰세요.
- 처음 추가할 때는 몇 초 걸릴 수 있습니다. 수집이 끝날 때까지 지표와 협업 정보는 비어 있습니다.
- 카탈로그 검색에는 안 나오고 프로필을 읽으면 비어 있는 핸들은 이름만 등록된 계정입니다. 이 호출이 그 계정을 수집합니다.
관련 도구
- solari_catalog_instagram_account_search사용자 이름, 이름, 소개글 문구로 SOLARI에 모인 Instagram 계정을 찾습니다. account_id가 필요할 때 쓰세요.
- solari_catalog_instagram_account_profileInstagram 계정의 프로필, 성과, 최근 게시물.
- solari_fetch_instagram_postsInstagram 계정의 게시물·릴스·태그된 게시물을 실시간으로 수집합니다.
에이전트용 문서: /docs/tools/fetch-instagram-account.md