--- name: "media-detail" description: "Read structured social media content details and metrics from content IDs, URLs, short links, or share text for supported platforms including Xiaohongshu / XHS / RedNote, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels. For WeChat Official Account articles, read article details and body text from article links." source_client: "socialdatax-skills" source_platform: "github" source_skill: "media-detail" metadata: openclaw: requires: env: - "SOCIALDATAX_API_KEY" bins: - "node" - "npm" primaryEnv: "SOCIALDATAX_API_KEY" install: - kind: "node" package: "socialdatax-skills" bins: [] emoji: "📄" homepage: "https://socialdatax.com/ai?from=github" --- # Media Detail Use this skill when the user provides an mp.weixin.qq.com article link and wants WeChat Official Account article body text. For other supported content links, short links, share text, or content IDs, use it for structured details or interaction metrics where supported. Current platform support: - Xiaohongshu / XHS / RedNote notes through the `xhs_get_note_detail_by_*` tools. - Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_detail_by_*` tools. - Kuaishou / 快手 works through the `kuaishou_get_video_detail_by_*` tools. - Bilibili / 哔哩哔哩 / B站 videos, articles, and dynamics through the `bilibili_get_content_detail_by_*` tools. - Zhihu / 知乎 answers, articles, and videos through `zhihu_get_content_detail_by_url`. - Instagram posts through the `instagram_get_post_detail_by_*` tools. - X / Twitter posts through the `x_get_post_detail_by_*` tools. - YouTube videos through `youtube_get_video_detail_by_url`. - TikTok videos and image posts through `tiktok_get_post_detail_by_url`. - Weibo / 微博 posts through the `weibo_get_post_detail_by_*` tools. - WeChat Channels / 视频号 video and image-post details through the `wechat_get_video_detail_by_*` tools. - WeChat Official Account / 微信公众号 articles through `wechat_get_mp_article_detail_by_url`. ## API Key Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains. 获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。 ## Preferred Direct CLI Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration: ```bash npx -y socialdatax-skills@latest xhs detail \ --note-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest xhs detail \ --url "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest douyin detail \ --aweme-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest douyin detail \ --url "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest kuaishou detail \ --photo-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest kuaishou detail \ --url "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest bilibili detail \ --content-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest bilibili detail \ --url "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest zhihu detail \ --content-url "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest instagram detail \ --post-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest instagram detail \ --post-url "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest x detail \ --post-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest x detail \ --post-url "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest youtube detail \ --url "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest tiktok detail \ --url "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest weibo detail \ --post-id "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest weibo detail \ --post-url "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest wechat detail \ --encrypted-object-id "" --pretty \ --source-client socialdatax-skills --source-platform github \ --source-skill media-detail npx -y socialdatax-skills@latest wechat detail \ --url "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail npx -y socialdatax-skills@latest wechat article \ --url "" --pretty --source-client socialdatax-skills \ --source-platform github --source-skill media-detail ``` Optional arguments: - XHS `--note-id `: use the entire `note_id` returned from search, comments, creator note lists, or a previous detail result; do not pass only a prefix. - XHS `--url `: use for a note link, short link, or share text. - Douyin `--aweme-id `: preferred when the Douyin work ID is already known. - Douyin `--url `: use for a Douyin content page URL, short link, or share text; do not pass `video.play_url`. - `--pretty`: output formatting only. - Kuaishou `--photo-id `: preferred when the Kuaishou work photo_id is already known. - Kuaishou `--url `: use for a Kuaishou work page URL, short link, or share text. - Bilibili `--content-id `: preferred when the Bilibili content ID is already known. - Bilibili `--url `: use for a Bilibili video, article, dynamic, short link, or share text. - Zhihu `--content-url `: use for a Zhihu answer, article, or video URL. - Instagram `--post-id `: preferred when the Instagram post ID is already known. - Instagram `--post-url `: use for an Instagram post URL. - X / Twitter `--post-id `: preferred when the X post ID is already known. - X / Twitter `--post-url `: use for an X post URL. - YouTube `--url `: use for a YouTube video URL. - TikTok `--url `: use for a TikTok post URL or share text. - Weibo `--post-id `: preferred when the Weibo post ID is already known. - Weibo `--post-url `: use for a Weibo post URL, short link, or share text. - WeChat Channels / 视频号 `--encrypted-object-id `: use when the encrypted_object_id from search is already known. - WeChat Channels / 视频号 `--url `: use for a WeChat Channels video or image-post link or share text. - WeChat Official Account / 微信公众号 `article --url `: use for an mp.weixin.qq.com article link or share text. - `--source-client socialdatax-skills --source-platform github --source-skill media-detail`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill. Use either the ID option or the URL option for detail commands, not both. The command prints JSON with `platform`, `tool`, `arguments`, and `data`. ## Safety Boundary Platform detail access is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime for SocialDataX detail requests. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. The optional XHS, Douyin, Kuaishou, Weibo, and X / Twitter local save commands write only to the requested local `--output` path or `--output-dir` directory and do not require `SOCIALDATAX_API_KEY`. The optional WeChat Channels / 视频号 local save command writes only to the user-provided `--output` file, decrypts when needed, and does not require `SOCIALDATAX_API_KEY`. ## MCP Tools MCP tools matching the direct CLI commands above: - `xhs_get_note_detail_by_note_id` - `xhs_get_note_detail_by_note_url` - `douyin_get_video_detail_by_aweme_id` - `douyin_get_video_detail_by_url` - `kuaishou_get_video_detail_by_photo_id` - `kuaishou_get_video_detail_by_url` - `bilibili_get_content_detail_by_id` - `bilibili_get_content_detail_by_url` - `zhihu_get_content_detail_by_url` - `instagram_get_post_detail_by_post_id` - `instagram_get_post_detail_by_post_url` - `x_get_post_detail_by_post_id` - `x_get_post_detail_by_post_url` - `youtube_get_video_detail_by_url` - `tiktok_get_post_detail_by_url` - `weibo_get_post_detail_by_post_id` - `weibo_get_post_detail_by_post_url` - `wechat_get_video_detail_by_encrypted_object_id` - `wechat_get_video_detail_by_url` - `wechat_get_mp_article_detail_by_url` If MCP tools are already available in the current agent, use one of these tools: - `xhs_get_note_detail_by_note_id`: use when the full `note_id` is already known; do not pass only a prefix. - `xhs_get_note_detail_by_note_url`: use for note URLs, short links, or share text. - `douyin_get_video_detail_by_aweme_id`: use when an aweme_id is already known. - `douyin_get_video_detail_by_url`: use for Douyin content page URLs, short links, or share text; do not pass playback URLs such as `video.play_url`. - `kuaishou_get_video_detail_by_photo_id`: use when a photo_id is already known. - `kuaishou_get_video_detail_by_url`: use for Kuaishou work page URLs, short links, or share text. - `bilibili_get_content_detail_by_id`: use when a Bilibili content_id is already known. - `bilibili_get_content_detail_by_url`: use for Bilibili video, article, dynamic, short link, or share text. - `zhihu_get_content_detail_by_url`: use for Zhihu answer, article, or video URLs. - `instagram_get_post_detail_by_post_id`: use when an Instagram post_id is already known. - `instagram_get_post_detail_by_post_url`: use for Instagram post URLs. - `x_get_post_detail_by_post_id`: use when an X post_id is already known. - `x_get_post_detail_by_post_url`: use for X post URLs. - `youtube_get_video_detail_by_url`: use for YouTube video URLs. - `tiktok_get_post_detail_by_url`: use for TikTok post URLs or share text. - `weibo_get_post_detail_by_post_id`: use when a post_id is already known. - `weibo_get_post_detail_by_post_url`: use for Weibo post URLs, short links, or share text. - `wechat_get_video_detail_by_encrypted_object_id`: use when encrypted_object_id from search is already known. - `wechat_get_video_detail_by_url`: use for a WeChat Channels / 视频号 video or image-post link or share text. - `wechat_get_mp_article_detail_by_url`: use for WeChat Official Account / 微信公众号 article links or share text. ## Output Guidance Return factual fields such as title or description, content, author, publish time, interaction counts, images, and media summary when available. For XHS detail results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`; if `note_url` is null, show the `note_id` or say that no directly openable full link is available. For XHS `note_id`, copy the entire returned `note_id` exactly; do not pass or display only a prefix. When the user wants to save XHS images or videos after detail, pass each returned `image_items[].image_url`, `image_items[].live_photo.video_url`, or `video.video_url` to `npx -y socialdatax-skills@latest xhs download-media --url "" --output-dir --pretty`; this local save command does not require `SOCIALDATAX_API_KEY`. For Douyin detail, include `content_type` when available. For Douyin detail, use `images` for image/text posts; `video` is the platform player resource and may be audio for image/text posts; `music` is the bound music or original-sound asset. When the user wants to save Douyin media after detail, pass each returned `images[].url`, `images[].live_photo.play_url`, `video.play_url`, `music.play_url`, or `cover_image_url` to `npx -y socialdatax-skills@latest douyin download-media --url "" --output-dir --pretty`; this local save command does not require `SOCIALDATAX_API_KEY`. When the user wants to save Kuaishou media after detail, pass each returned `images[].url`, `video.play_url`, or `cover_image_url` to `npx -y socialdatax-skills@latest kuaishou download-media --url "" --output-dir --pretty`; this local save command does not require `SOCIALDATAX_API_KEY`. For Bilibili detail, preserve returned content IDs and URLs because comments, replies, and article/dynamic reactions may need them. For Zhihu, Instagram, X / Twitter, YouTube, and TikTok detail results, keep the returned URL and public content ID values exactly as returned for follow-up comments or creator lookups. When the user wants to save X / Twitter media after search or detail, pass each returned `media_items[].cover_image_url` or `media_items[].video_url` to `npx -y socialdatax-skills@latest x download-media --url "" --output-dir --pretty`; this local save command does not require `SOCIALDATAX_API_KEY`. Search results may already include these media URLs; use detail as a fallback when search media fields are absent. If an X / Twitter local media download times out, explain that X media is served from overseas CDN domains such as `pbs.twimg.com` and `video.twimg.com`; ask the user to make the download process use their proxy, for example by adding `--proxy "http://127.0.0.1:7890"` or setting `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY`, then retry the same `x download-media` command. Detail access is read-only and does not provide account actions. For Weibo detail, include `post_id`, content, author, media, interaction counts, publish time, and post URL when available. When the user wants to save Weibo media after detail, pass each returned `image_urls[]` or `video.video_url` to `npx -y socialdatax-skills@latest weibo download-media --url "" --output-dir --pretty`; this local save command does not require `SOCIALDATAX_API_KEY`. For WeChat Channels / 视频号 detail, preserve `object_id` and `object_nonce_id` because comments and replies need both values. When the user wants to save a WeChat Channels / 视频号 video after detail, pass the returned `video.video_url` to `npx -y socialdatax-skills@latest wechat decrypt-media --media-url "" --output `; this local save command decrypts when needed and does not require `SOCIALDATAX_API_KEY`. For WeChat Official Account / 微信公众号 article detail, include article title, account, publish time, body text, image URLs, linked articles, and embedded video cards when present. ## Troubleshooting - If an SDK/dependency, npm network, Node.js/npm/npx availability, permission, or missing runtime error appears, treat it as a local runtime, dependency installation, network, or agent authorization issue, not a SocialDataX API key or business data error. If the current environment has permission, install or restore automatically. When network or execution authorization is needed, ask the user to approve or finish authorization, then continue the same command; do not use public web search as a substitute for SocialDataX data. - For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate. - If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges. - If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.