← Back to Skills Marketplace
justoneapi

Toutiao API

by justoneapi · GitHub ↗ · v1.0.7 · MIT-0
cross-platform ✓ Security Clean
175
Downloads
0
Stars
1
Active Installs
8
Versions
Install in OpenClaw
/install justoneapi-toutiao
Description
Analyze Toutiao workflows with JustOneAPI, including article Details, user Profile, and app Keyword Search across 4 operations.
README (SKILL.md)

Toutiao

This skill wraps 4 Toutiao operations exposed by JustOneAPI. It is strongest for article Details, user Profile, app Keyword Search, and web Keyword Search. Expect common inputs such as keyword, id, page, searchId, userId.

When To Use It

  • The user needs article Details or user Profile on Toutiao.
  • The task lines up with app Keyword Search rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as keyword, id, page, searchId.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getToutiaoArticleDetailV1: Article Details — Get Toutiao article Details data, including article ID, title, and author information, for content performance analysis and media monitoring and verifying article authenticity and metadata retrieval
  • getToutiaoUserDetailV1: User Profile — Get Toutiao user Profile data, including user ID, nickname, and avatar, for influencer profiling and audience analysis and monitoring creator performance and growth
  • searchToutiaoV1: App Keyword Search — Get Toutiao app Keyword Search data, including matching articles, videos, and authors, for topic discovery and monitoring
  • searchV2: Web Keyword Search — Get Toutiao web Keyword Search data, including this is the PC version of the search API. Note that it currently only supports retrieving the first page of results, for first-page discovery of articles, videos, and authors for trend research and monitoring

Request Pattern

  • 4 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are keyword, id, page, searchId, userId.
  • All operations in this skill are parameter-driven requests; none require a request body.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: getToutiaoArticleDetailV1, getToutiaoUserDetailV1, searchToutiaoV1, searchV2.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

  • Required: JUST_ONE_API_TOKEN
  • This skill uses JUST_ONE_API_TOKEN only for authenticated Just One API requests.
  • Keep JUST_ONE_API_TOKEN private. Do not paste it into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Rules

  • Start with a plain-language answer tied to the Toutiao task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getToutiaoArticleDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as keyword, id, page, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill is a small Node-based wrapper that sends your JUST_ONE_API_TOKEN to api.justoneapi.com for four GET endpoints. Before installing: confirm you trust JustOneAPI and that the token you provide has only the minimum privileges you need. Keep the token secret (do not paste it in chat). Note the CLI passes the token as a query parameter (which can be recorded by proxies/logs); if that matters for your environment, prefer tokens with limited scope or consult the provider. The skill can be invoked by the agent (normal), so if you want to avoid autonomous calls, disable or restrict use of third‑party skills in your agent settings.
Capability Analysis
Type: OpenClaw Skill Name: justoneapi-toutiao Version: 1.0.7 The skill is a standard API wrapper for the JustOneAPI service, providing access to Toutiao article details, user profiles, and search functionality. The execution script `bin/run.mjs` is a clean implementation that uses the built-in Node.js fetch API to communicate with `api.justoneapi.com`. There are no signs of data exfiltration, malicious code execution, or prompt injection; the instructions in `SKILL.md` correctly guide the agent on how to use the API safely while protecting the user's API token.
Capability Assessment
Purpose & Capability
Name/description describe Toutiao queries. The skill requires node and a single API token (JUST_ONE_API_TOKEN) which is consistent with a small wrapper that issues authenticated HTTP GET requests to api.justoneapi.com.
Instruction Scope
SKILL.md tells the agent to select one of four parameter-driven GET operations, ask the user for any missing parameters, and run the local node helper with the token. The instructions do not request unrelated files, other env vars, or exfiltrate data to unexpected endpoints.
Install Mechanism
There is no install spec; the shipped code is a small node CLI (bin/run.mjs). No downloads from external or untrusted URLs or extraction steps are present.
Credentials
Only JUST_ONE_API_TOKEN is required and declared as the primary credential. The token is used only to call JustOneAPI endpoints per manifest and SKILL.md; no unrelated credential or high-privilege env variables are requested.
Persistence & Privilege
always is false and disable-model-invocation is false (normal). The skill does not request persistent system-wide configuration or modification of other skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-toutiao
  3. After installation, invoke the skill by name or use /justoneapi-toutiao
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
- Updated operation IDs to include "Toutiao" prefix for improved clarity (e.g., getToutiaoArticleDetailV1). - Adjusted documentation and examples to use the new operation IDs. - No changes to API behavior or endpoints—naming only.
v1.0.6
- Updated authentication documentation links in the Environment section to use referral URLs. - No changes to skill functionality or operation logic.
v1.0.5
- Updated the Just One API Dashboard link to include tracking parameters for referrals from this skill. - No changes to functionality or API usage; documentation improved for clarity and proper token registration links.
v1.0.4
- Updated SKILL.md to clarify that JUST_ONE_API_TOKEN is only used for authenticated Just One API requests. - No changes to functionality or API operations—documentation update only.
v1.0.3
- Added a privacy instruction: Keep the `JUST_ONE_API_TOKEN` private and do not paste it into chat messages, screenshots, or logs. - No changes to functionality, operations, or parameters.
v1.0.2
- Added guidance on obtaining the required JUST_ONE_API_TOKEN from the Just One API Dashboard. - Linked to the Just One API Usage Guide for authentication details. - No changes to operations or API usage. Documentation improvement only.
v1.0.1
rename
v1.0.0
- Initial release of the Toutiao API skill, powered by JustOneAPI. - Supports 4 key operations: article details, user profile, app keyword search, and web keyword search. - Parameter-driven design with required inputs such as `keyword`, `id`, `page`, and user-specific identifiers. - Provides clear usage guidelines and output rules for accurate, API-backed responses. - Requires a JUST_ONE_API_TOKEN environment variable for operation.
Metadata
Slug justoneapi-toutiao
Version 1.0.7
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 8
Frequently Asked Questions

What is Toutiao API?

Analyze Toutiao workflows with JustOneAPI, including article Details, user Profile, and app Keyword Search across 4 operations. It is an AI Agent Skill for Claude Code / OpenClaw, with 175 downloads so far.

How do I install Toutiao API?

Run "/install justoneapi-toutiao" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Toutiao API free?

Yes, Toutiao API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Toutiao API support?

Toutiao API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Toutiao API?

It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.7.

💬 Comments