One-command installer for public social-media metadata, text, timed transcripts, media, and MCP tools
Server has 6 tools with complete input schemas and descriptions, but quality is uneven. Tool names follow verb_noun convention (social_inspect, social_get_text, social_get_comments, social_download, social_capture_bundle, social_doctor). Descriptions are present but vary in clarity, some are specific (social_inspect: 'Parse one public URL into PostBundle'), others are vague (social_capture_bundle: 'Build one PostBundle'). Parameters have types and descriptions, but lack constraints (enums, ranges, patterns). No output schemas documented. Error handling and recovery guidance absent. No tool annotations (readOnlyHint/destructiveHint). Risk labels present in metadata but not exposed to LLM.
Build one PostBundle and optionally attach comments and explicit downloads.
Show dependency/configuration status and secret names, never secret values.
Explicitly download selected media and return a checksum manifest.
Return up to 1-100 comments from Douyin's available public sample.
Get canonical text, or write timed YouTube MD/SRT/JSON artifacts.
Parse one public URL into PostBundle; never download media or run ASR.
No output schemas documented. LLMs cannot plan downstream calls or extract fields without knowing response structure. social_inspect, social_get_text, social_capture_bundle return complex PostBundle objects with undocumented fields.
Missing tool annotations. Risk labels (READ_ONLY, WRITE, WRITE) exist in metadata but are not exposed via destructiveHint/readOnlyHint in tool definitions. LLMs cannot infer safety properties.
Parameter constraints missing. social_get_comments accepts limit 1-100 but no min/max validation visible. social_get_text has complex conditional logic (timed=true requires output_dir, force_asr=true requires asr_context_json) undocumented in descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
No error handling or recovery guidance. Tools lack descriptions of failure modes, retryability, or next steps. E.g., social_inspect 'never download media' but no error if URL is invalid or private.
social_capture_bundle combines multiple concerns (text extraction, comments, downloads). Violates single-responsibility principle. LLM cannot compose independently.