How can an assistant or workflow retrieve actual social data?
An assistant retrieves actual social data when the assistant’s client can call BeatAPI tools: connect the remote MCP server https://beatapi.io/mcp and check that capabilities_search, capabilities_inspect and capabilities_run appear. A workflow retrieves actual data when an HTTP step POSTs to https://api.beatapi.io/v1/social-data/call. Use a fixed HTTP workflow when the steps never change, and let the assistant choose tools when the questions vary.
For example, you want to select installation tutorials from a WeChat Official Account, then see what questions users ask on Xiaohongshu and Douyin. Check what your client can execute first, then choose the HTTP workflow or the assistant-selected tools.
Verify the client’s tools
- Add the server. If your client supports remote HTTP MCP and custom headers, set the server URL to
https://beatapi.io/mcp, and storeAuthorization: Bearer <BEATAPI_API_KEY>as a client credential. - Check the tool list. Confirm that the client lists
capabilities_search,capabilities_inspectandcapabilities_run. - Run a first check. Ask the assistant to find one action and inspect the action’s inputs, then request the agreed first batch.
- Keep the record. Save the action, status, request ID and the material actually read.
How CLI assistants, desktop extensions and hosted workflows connect depends on the client version, header support and network settings. If the connection fails, check tool discovery first, then check authentication, transport and execution separately. BeatAPI’s public reading actions use a BeatAPI key. An existing platform plugin manages its own account session and data source.
Use HTTP for a fixed sequence
In an environment with an HTTP step, POST to https://api.beatapi.io/v1/social-data/call with application/json and the BeatAPI key from the credential store. Send one target first and verify the response before adding selection and export steps.
To list a verified Official Account’s articles, use a separate step:
Pass only the selected article URLs to the article body step, and keep the original links and the selection reasons. If you already have saved Xiaohongshu or WeChat responses, go directly to selection and export. See Xiaohongshu table handoff and WeChat article inventory and statistics.
Choose an entry point for your environment
BeatAPI defines the MCP endpoint, HTTP endpoint, and tool schemas. Each client’s connection, templates and publishing still need checking in your own environment. An existing skill can store the task steps and reporting requirements; check the execution record, the response and the sources anyway.
Prompt for a connected assistant:
Use this verified Official Account identifier to fetch a batch of articles and read two about coffee machine cleaning. Find a batch of related Xiaohongshu and Douyin content. Deliver original evidence, material types, request count and what still needs reading.
To read more of the same saved result, see result reading. New pages and details are additional queries; see pricing.
For example, if your weekly brief reads the same accounts every week, use a fixed HTTP workflow that saves the accounts and their list pages. When an editor asks about an unexpected note, let a tool-enabled assistant choose the action. If the client cannot connect, give the model last week’s saved lists and notes, and label the collection date in the brief.
Check the input contract when handing off to an analysis tool
If an analysis tool such as BettaFish shows no data, check whether the tool reads files, database tables or tool calls.
- Save a small public Xiaohongshu and Douyin sample, keeping the original responses.
- Map the work IDs, text scope, date units and comment links that the installed tool version requires.
- Verify one saved record end to end, from import to query.
Check BettaFish’s actual schema and connection in your own installation. The BeatAPI workflow supplies traceable input files and does not write into BettaFish’s database.
Read social sources in Dify · Social lookups in Coze

