instagram · fetchsolari:read

solari fetch instagram post

URL로 Instagram 게시물 하나를 수집하고 작성자를 알려 줍니다.

MCP 도구

solari_fetch_instagram_post

권한

solari:read

이용 가능 플랜

무료 체험
Plus
Pro
Enterprise

크레딧

개요

공개 URL이나 shortcode로 Instagram 게시물 하나를 SOLARI 카탈로그에 수집하고, 누가 올렸는지 알려 줍니다. 이미 저장된 게시물이면 새로 수집하지 않습니다.

언제 쓰나요 — 게시물 링크는 있는데 catalog content detail이 item=null을 돌려주고, 작성자도 모를 때 쓰세요.

돌려주는 값 — 수집됐는지 여부, 작성자 정보가 붙은 게시물, 그 작성자를 수집하는 fetch 명령.

파라미터

urlstring선택: 게시물 공개 URL(/p/, /reel/, /tv/).≤ 512 chars
slugstring선택: Instagram shortcode. url보다 우선입니다.pattern ^[A-Za-z0-9_-]{3,20}$

응답

Response

ingestedboolean: 이번 호출에서 바로 수집했으면 true.
already_trackedboolean: 이미 카탈로그에 있었으면 true.
fetched_on_demandboolean: ingested와 같은 값.
foundboolean: Instagram에 해당하는 공개 게시물이 없으면 false.
post_iduuid: 저장된 게시물.
account_iduuid: 작성자 계정.
usernamestring: 작성자 핸들.
itemobject | null: 미디어 파일이 붙은 게시물.
notestring: 다음에 일어날 일.
nextstring: 작성자를 수집하는 fetch 명령.

item

post_iduuid: 다른 콘텐츠 도구에 넣을 게시물 id.
slugstring: 공개 URL에 들어 있는 shortcode.
author_iduuid: 작성자 account_id.
usernamestring: 작성자 username.
full_namestring | null: 표시 이름.
profile_pic_urlstring | null: 프로필 사진 URL.
follower_countinteger | null: 작성자 팔로워 수.
regionstring | null: 작성자 지역.
posted_attimestamp: 게시 시각(UTC).
media_typestring: image, video, carousel 중 하나.
play_countinteger | null: 영상 재생 수. 이미지면 null.
like_countinteger | null: 좋아요 수.
textstring | null: 캡션.
media_urlstring: 미디어 URL.
thumbnail_urlstring: 썸네일 URL.
scorenumber | null: 순위 점수. 순위가 매겨진 목록이 아니면 null.
efficiency_scorenumber | null: 작성자 팔로워 수 대비 성과.
est_percentilenumber | null: 지역 내 백분위. 0~1.
total_views_3minteger | null: 최근 3개월 동안 작성자의 조회 수.
median_views_3minteger | null: 최근 3개월 동안 작성자의 조회 수 중앙값.
recent_collab_brandsstring[]: 작성자가 최근 협업한 브랜드.
item_typestring: 항목 종류. 항상 "content".
content_sourcestring | null: 게시물이 나온 피드. 피드에서 온 게 아니면 null.
is_savedboolean | null: SOLARI에 이 게시물을 저장했는지. 알 수 없으면 null.
updated_attimestamp | null: 지표를 마지막으로 갱신한 시각.
assetsobject[]: 미디어 파일 목록(순서대로). 각 항목에 asset_url, media_type, video_duration이 있습니다.
assets[].asset_urlstring | null: 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null.

예시

요청

$ solari fetch instagram post url=https://www.instagram.com/p/DcyMAmUh6FZ/

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.

{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "username": "innisfreeofficial",
  "item": {
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "item_type": "content",
    "post_id": "01a06275-d974-7fda-98ee-dd3ee15b4dcf",
    "author_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "username": "innisfreeofficial",
    "slug": "DcyMAmUh6FZ",
    "posted_at": "2026-09-02T12:00:06Z",
    "media_type": "video",
    "play_count": 22467,
    "like_count": 3224
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch instagram account username=innisfreeofficial"
}

MCP 호출

{
  "name": "solari_fetch_instagram_post",
  "arguments": {
    "url": "https://www.instagram.com/p/DcyMAmUh6FZ/"
  }
}

주의사항

작성자는 이름만 등록된 계정으로 옵니다. 프로필과 게시물을 수집하려면 next에 있는 명령(fetch instagram account)을 실행하세요.
처음 수집할 때는 몇 초 걸립니다.

에이전트용 문서: /docs/tools/fetch-instagram-post.md

개요

파라미터

응답

예시

주의사항

관련 도구