instagram · fetch · postsolari:read
solari fetch instagram post assets
Instagram の投稿 1 件の元サイズのダウンロードリンク。
- MCP ツール
- solari_fetch_instagram_post_assets
- CLI
- solari fetch instagram post assets
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
Instagram の投稿 1 件のメディアファイルすべてについて、Instagram が配信する最大サイズの新しいダウンロードリンクを返します。リール、写真または動画 1 件、カルーセルの全スライドが対象です。呼び出すたびに Instagram からその場で読み込みます。
どんなときに使うか — 投稿の元ファイルが必要なときに使います。他のツールの assets は保存済みのコピーを指していて、元より小さいことがあります。
返される内容 — 投稿者と投稿の種類、そしてメディアファイルごとのダウンロードリンク(順番どおり)。
パラメータ
- urlstring任意
- 投稿の公開 URL(/p/、/reel/、/tv/)。≤ 512 chars
- slugstring任意
- Instagram のショートコード。url より優先されます。pattern ^[A-Za-z0-9_-]{3,20}$
レスポンス
Response
- foundboolean
- その指定に該当する公開投稿が Instagram にない場合は false。
- slugstring | null
- 投稿の shortcode。
- urlstring | null
- 公開パーマリンク。
- usernamestring | null
- 投稿者のハンドル。
- post_typestring | null
- reel、video、photo、carousel のいずれか。
- media_countinteger
- assets に含まれるファイル数。
- assetsobject[]
- メディアファイルの一覧(順番どおり)。
- notestring | null
- ダウンロードできるファイルがない場合の理由。
assets[]
- indexinteger
- 投稿内でのファイルの順番。1 から始まります。
- media_typestring
- video または image。
- asset_urlstring
- プラットフォームが配信する最大サイズのファイルのダウンロードリンク。一時的なリンクなので、すぐにダウンロードしてください。
- fallback_urlsstring[]
- 同じファイルの別リンク。asset_url が失敗したときに順番に試します。
- widthinteger | null
- 幅(ピクセル)。分かる場合のみ。
- heightinteger | null
- 高さ(ピクセル)。分かる場合のみ。
- video_durationnumber | null
- 動画の長さ(秒)。
- file_extensionstring
- 保存時に使うファイル拡張子。例:mp4、jpg。
- size_bytesinteger | null
- ファイルサイズ(バイト)。分かる場合のみ。
- refererstring | null
- ダウンロード時に Referer ヘッダーとして送る値。不要な場合は null です。
例
リクエスト
$ solari fetch instagram post assets slug=DcyMAmUh6FZレスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"found": true,
"slug": "DcyMAmUh6FZ",
"video_id": null,
"url": "https://www.instagram.com/p/DcyMAmUh6FZ/",
"username": "innisfreeofficial",
"post_type": "reel",
"media_count": 1,
"assets": [
{
"index": 1,
"media_type": "video",
"asset_url": "https://scontent-cph2-1.cdninstagram.com/….mp4?…",
"fallback_urls": [],
"width": 720,
"height": 1280,
"video_duration": 23.868,
"file_extension": "mp4",
"size_bytes": null,
"referer": null
}
],
"note": null
}MCP で呼び出す場合
{
"name": "solari_fetch_instagram_post_assets",
"arguments": {
"slug": "DcyMAmUh6FZ"
}
}注意点
- ファイルを一度に保存するには solari instagram download content slugs=… dir=… を実行してください。このツールを呼び出し、すべてのファイルをダウンロードします。
- リンクは一時的な署名付きリンクです。すぐにダウンロードし、再度必要なら呼び出し直してください。
- 呼び出すたびに Instagram へ問い合わせるため、数秒かかります。