# WeChat (微信) data for AI agents

> ToolSocket gives Claude, ChatGPT, Cursor, Codex and any MCP or REST client live access to WeChat (微信) — WeChat Channels (视频号) accounts, videos and comments, Official Account (公众号) articles, and WeChat search — through 22 ready-made tools. No WeChat account, scraper or API key of your own is needed: connect https://toolsocket.top/mcp once and pay per call (most calls $0.015).

ToolSocket 让 Claude、ChatGPT、Cursor、Codex 等任何支持 MCP 或 REST 的 AI 智能体，直接读取微信的实时数据：视频号账号、作品和评论，公众号文章，以及微信搜一搜，共 22 个工具。不用注册微信账号、不用写爬虫，接入一个地址即可，按次计费（大多 $0.015/次）。

## Connect

- MCP (Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Codex): `https://toolsocket.top/mcp` — OAuth sign-in or `Authorization: Bearer ts_live_…`
- Claude Code: `claude mcp add --transport http toolsocket https://toolsocket.top/mcp`
- Any agent that reads skills: `set up https://toolsocket.top/SKILL.md`
- Setup for every client: https://toolsocket.top/docs.md

## Example

Ask your agent: "What did this WeChat Official Account publish this month, and which articles did best?" / 「这个公众号这个月发了哪些文章？哪篇数据最好？」

```bash
curl -s -X POST https://toolsocket.top/v1/run -H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
  -H "content-type: application/json" -d '{"tool":"wechat_channels#v2/fetch_search_channel_videos","input":{"username":"v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder","keyword":"新闻","raw":true},"wait":30}'
```

## Tools (22)

| Tool | ID | Price | What it does |
|---|---|---|---|
| WeChat Channels · Get WeChat Channels Account Info (v2) · 微信视频号 · 获取视频号账号信息（v2） | `wechat_channels#v2/fetch_channel_info` | $0.015 / call | Get the "More Info" of a WeChat Channels account: basic info section (IP location / profile location / **Channel ID** = public sph ID) + verification section (service unit / entity type / internet news service license n… |
| WeChat Channels · Convert Channel ID to Finder Username (v2) · 微信视频号 · 视频号ID转finder username（v2） | `wechat_channels#v2/fetch_channel_id_to_username` | $0.015 / call | Resolve a publicly visible Channel ID (sph… short ID) into a finder username (v2_…@finder). |
| WeChat Channels · Get WeChat Channels User Videos (v2) · 微信视频号 · 获取视频号用户作品列表（v2） | `wechat_channels#v2/fetch_user_videos` | $0.015 / call | Get the video list from a WeChat Channels account's homepage. |
| WeChat Channels · Get WeChat Channels Video Detail (v2) · 微信视频号 · 获取视频号作品详情（v2） | `wechat_channels#v2/fetch_video_detail` | $0.015 / call | Get the full detail of a WeChat Channels video (media address media + decode_key). |
| WeChat Channels · Get WeChat Channels Video Comments (v2) · 微信视频号 · 获取视频号作品评论（v2） | `wechat_channels#v2/fetch_video_comments` | $0.015 / call | Get first-level comments of a video (with IP region / like count); pass comment_id to get second-level replies under that comment. |
| WeChat Channels · Generate WeChat Channels Video Share URL (v2) · 微信视频号 · 生成视频号作品分享链接（v2） | `wechat_channels#v2/fetch_video_share_url` | $0.015 / call | Given a video object_id, return a shareable weixin.qq.com/sph/… short link (the inverse of the share_url input of fetch_video_detail). |
| WeChat Channels · Get WeChat Channels User Profile & Stats (v2) · 微信视频号 · 获取视频号账号主页资料+统计（v2） | `wechat_channels#v2/fetch_user_profile` | $0.015 / call | Get a creator's homepage profile and interaction stats. **Complementary** to fetch_channel_info (verification entity / license): this endpoint provides nickname / signature / avatar, follower / video / like / favorite /… |
| WeChat Channels · Get WeChat Channels User Collections (v2) · 微信视频号 · 获取视频号合集列表（v2） | `wechat_channels#v2/fetch_user_collections` | $0.015 / call | Get the "Collections" list on a creator's homepage. Pass each collection's topic_id to fetch_collection_videos to get its videos. |
| WeChat Channels · Get WeChat Channels Collection Videos (v2) · 微信视频号 · 获取视频号合集内视频（v2） | `wechat_channels#v2/fetch_collection_videos` | $0.015 / call | Given a collection topic_id (from fetch_user_collections), return the video list inside that collection. |
| WeChat Channels · Get WeChat Channels Live History (v2) · 微信视频号 · 获取视频号直播回放列表（v2） | `wechat_channels#v2/fetch_live_history` | $0.015 / call | Get a creator's live replay list. Each replay is itself a video object with a media object (url / url_token / decode_key) ready for download and decryption. |
| WeChat Channels · Get WeChat Channels Live Detail (v2) · 微信视频号 · 获取视频号直播间详情（v2） | `wechat_channels#v2/fetch_live_detail` | $0.015 / call | Pass a live live_id to get live-room detail: anchor info, live status, online count, replay info, etc. |
| WeChat Channels · Search Videos Within a WeChat Channel (v2) · 微信视频号 · 视频号号内搜索（v2） | `wechat_channels#v2/fetch_search_channel_videos` | $0.015 / call | In-channel search: search a creator's published videos by keyword **within that channel only**. |
| WeChat Official Accounts · Get WeChat MP Article Detail (v2) · 微信公众号 · 获取公众号文章详情（v2） | `wechat_mp#v2/fetch_article_detail` | $0.015 / call | Pass an article URL to get the article body / title / author / cover / publish time / album info. |
| WeChat Official Accounts · Get WeChat MP Article Detail (H5, Recommended) (v2) · 微信公众号 · 获取公众号文章详情（H5 版本，推荐）（v2） | `wechat_mp#v2/fetch_article_detail_h5` | $0.015 / call | Fetch WeChat MP article detail via the H5 channel. **Recommended by default**: the body is |
| WeChat Official Accounts · Get WeChat MP Article Stats (H5) (v2) · 微信公众号 · 获取公众号文章互动数据（H5 版本）（v2） | `wechat_mp#v2/fetch_article_stats_h5` | $0.015 / call | Fetch comment counts for a WeChat MP article via the H5 channel. |
| WeChat Official Accounts · Get WeChat MP Article Stats (v2) · 微信公众号 · 获取公众号文章互动数据（v2） | `wechat_mp#v2/fetch_article_stats` | $0.015 / call | Pass an article URL to get its interaction metrics (reads / likes / "wow" / shares / favorites / comments). |
| WeChat Official Accounts · Get WeChat MP Article Comments (v2) · 微信公众号 · 获取公众号文章评论（v2） | `wechat_mp#v2/fetch_article_comments` | $0.015 / call | Get WeChat MP article comments (single page, buffer cursor pagination); returns one page of featured comments. |
| WeChat Official Accounts · Get WeChat MP Article Ads (v2) · 微信公众号 · 获取公众号文章广告（v2） | `wechat_mp#v2/fetch_article_ad` | $0.015 / call | Pass an article URL to get the embedded ad slot info of the article. This endpoint responds relatively slowly, please be patient; articles without ads return empty. |
| WeChat Official Accounts · Get WeChat MP Account Profile (v2) · 微信公众号 · 获取公众号资料页（v2） | `wechat_mp#v2/fetch_account_profile` | $0.015 / call | Pass an account username to get the profile: nickname / IP region / original article count / verification entity type / linked Channels account, etc. |
| WeChat Official Accounts · Get WeChat MP Account Articles (v2) · 微信公众号 · 获取公众号文章列表（v2） | `wechat_mp#v2/fetch_account_articles` | $0.015 / call | Pass a gh_username to get a **single page** of the account's historical posts (**article** tab). |
| WeChat Search · WeChat Universal Search (v2) · 微信搜一搜 · 微信综合搜索（搜一搜）（v2） | `wechat_search#v2/fetch_search` | $0.015 / call | WeChat "Search" (搜一搜) universal search; the vertical is switched by the business_type **string key** — just pass a keyword. |
| WeChat Search · WeChat Channels Video Search (v2) · 微信搜一搜 · 搜视频号视频（时长/排序/时间筛选）（v2） | `wechat_search#v2/fetch_search_videos` | $0.015 / call | Search WeChat Channels videos specifically (video vertical), with the result page's "duration" filter, "relevance/newest/most-liked" sort, and "time" dropdown. |
