Перейти к навигации

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

  1. Add the server. If your client supports remote HTTP MCP and custom headers, set the server URL to https://beatapi.io/mcp, and store Authorization: Bearer <BEATAPI_API_KEY> as a client credential.
  2. Check the tool list. Confirm that the client lists capabilities_search, capabilities_inspect and capabilities_run.
  3. Run a first check. Ask the assistant to find one action and inspect the action’s inputs, then request the agreed first batch.
  4. 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.

{"action":"xiaohongshu.app_v2.search_notes","params":{"keyword":"咖啡机 清洁","page":1}}

To list a verified Official Account’s articles, use a separate step:

{"action":"wechat_mp.v2.fetch_account_articles","params":{"username":"<verified_username>","offset":"","item_show_type":0,"raw":false}}

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

EnvironmentCheck firstFirst delivery
Tool clients such as Claude Code, Cursor or CodexRemote HTTP MCP, auth headers and tool discoveryA sourced first batch of works or articles
Workflows such as Dify or CozeConfigurable HTTP for fixed steps, or verified MCP support for dynamic tool choiceInput, original response and selected links before requesting details
Desktop clients such as WorkBuddy, Doubao or Qwen WorkWhether the installed connector accepts the endpoint and headersConfirmed tool execution and response before expanding
A client using DeepSeek or another modelWhether the host can make tool calls or provide saved materialOriginal evidence distinguished from model summaries
Chat-only clientProvide saved content and its scopeSourced summaries, categories and gaps

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.

  1. Save a small public Xiaohongshu and Douyin sample, keeping the original responses.
  2. Map the work IDs, text scope, date units and comment links that the installed tool version requires.
  3. 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

Check BettaFish data and verify sample read-back

Configure each of the three desktop clients