← 返回 Skills 市场
jaencarrodine

X (Twitter) API

作者 Jaen · GitHub ↗ · v1.0.13 · MIT-0
cross-platform ✓ 安全检测通过
142
总下载
0
收藏
0
当前安装
6
版本数
在 OpenClaw 中安装
/install agntdata-x
功能描述
X (Twitter) API integration with a single agntdata API key (Bearer token). Read tweets, user profiles, followers, search, lists, trends, and hashtags. Use th...
使用说明 (SKILL.md)

X (Twitter) API

The agntdata X API wraps X surface areas into a single integration. Instead of managing multiple keys, proxies, and rate limits yourself, you call agntdata with one credential and consume structured JSON optimized for downstream AI and analytics. Whether you are building a social listening agent, a content research pipeline, or a creator-intelligence product, this API gives you consistent access to tweets, user profiles, followers, search, and hashtag streams with predictable billing and operational simplicity.

Recommended: Install the Plugin

For the best experience, install the OpenClaw plugin for X (Twitter) API instead of this skill. The plugin provides native MCP tools, automatic authentication, and structured parameter validation.

Skill (this document):

clawhub install agntdata-x

Plugin (native tools; npm package matches package.json):

openclaw plugins install @agntdata/openclaw-x

This skill is useful for environments where plugins are not supported.

Authentication

Before making API calls, you need an API key. Get one from the agntdata dashboard.

The API key should be available as the AGNTDATA_API_KEY environment variable. Every request must include it as a Bearer token:

Authorization: Bearer $AGNTDATA_API_KEY

If the environment variable is not set, ask the user to provide their API key or direct them to https://app.agntdata.dev/dashboard to create one.

API Key Activation

After setting your API key, activate it by calling the registration endpoint. This only needs to be done once per key:

curl -X POST https://api.agntdata.dev/v1/register \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intendedApis": ["x"], "useCase": "Brief description of your use case"}'

Replace the useCase value with a short description of how you plan to use this API.

Discovery Endpoints

These public endpoints (no API key required) let you explore this platform's capabilities:

curl https://api.agntdata.dev/v1/platforms/x

Returns: full endpoint list, OpenAPI spec, features, and use cases.

Base URL

https://api.agntdata.dev/v1/x

Available Endpoints

Method Path Summary
GET /user/medias/continuation Continuation User's Media
POST /user/medias/continuation Continuation User's Media
GET /user/medias User's Media
POST /user/medias User's Media
GET /user/likes/continuation Continuation User's Likes
POST /user/likes/continuation Continuation User's Likes
GET /user/likes User's Likes
POST /user/likes User's Likes
GET /user/followers/continuation Continuation User's Followers
POST /user/followers/continuation Continuation User's Followers
GET /user/followers User's Followers
POST /user/followers User's Followers
GET /user/following/continuation User's Following Continuation
POST /user/following/continuation User's Following Continuation
GET /user/tweets User's Tweets
POST /user/tweets User's Tweets
GET /user/tweets/continuation User's Tweets Continuation
POST /user/tweets/continuation User's Tweets Continuation
GET /user/details User Details
POST /user/details User Details
GET /user/about User About
GET /tweet/replies/continuation Tweet Replies Continuation
POST /tweet/replies/continuation Tweet Replies Continuation
GET /tweet/favoriters/continuation Tweet User Favoriters Continuation
GET /tweet/retweets/continuation Tweet User Retweets Continuation
GET /tweet/details Tweet Details
POST /tweet/details Tweet Details
GET /tweet/favoriters Tweet User Favoriters
GET /tweet/retweets Tweet User Retweets
GET /tweet/replies Tweet Replies
POST /tweet/replies Tweet Replies
GET /user/following User's Following
POST /user/following User's Following
GET /lists/tweets/continuation Lists Tweets Continuation
GET /search/search/continuation Search Continuation
POST /search/search/continuation Search Continuation
GET /ai/topic-classification Topic Classification
POST /translate/detect Detect
GET /ai/named-entity-recognition Named Entity Recognition
GET /ai/sentiment-analysis Sentiment Analysis
POST /translate Translate
GET /trends/available Available Locations (Beta)
GET /trends/ Get trends near a location (Beta)
GET /search/geo Geo Search (Beta)
GET /lists/tweets Lists Tweets
GET /lists/details Lists Details
GET /search/search Search
POST /search/search Search
GET /hashtag/hashtag Hashtag
POST /hashtag/hashtag Hashtag
GET /hashtag/hashtag/continuation Hashtag Continuation
POST /hashtag/hashtag/continuation Hashtag Continuation

Tool Schemas

The following JSON defines all available tools with their parameters. Each tool maps to an API endpoint.

[
  {
    "name": "agntdata_x_Continuation_User_s_Media_get__user_medias_continuation",
    "description": "Continuation User's Media",
    "method": "GET",
    "path": "/user/medias/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token",
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Media_post__user_medias_continuation",
    "description": "Continuation User's Media",
    "method": "POST",
    "path": "/user/medias/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Media_get__user_medias",
    "description": "User's Media",
    "method": "GET",
    "path": "/user/medias",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Media_post__user_medias",
    "description": "User's Media",
    "method": "POST",
    "path": "/user/medias",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Likes_get__user_likes_continuation",
    "description": "Continuation User's Likes",
    "method": "GET",
    "path": "/user/likes/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token",
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Likes_post__user_likes_continuation",
    "description": "Continuation User's Likes",
    "method": "POST",
    "path": "/user/likes/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Likes_get__user_likes",
    "description": "User's Likes",
    "method": "GET",
    "path": "/user/likes",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Likes_post__user_likes",
    "description": "User's Likes",
    "method": "POST",
    "path": "/user/likes",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Followers_get__user_followers_continuation",
    "description": "Continuation User's Followers",
    "method": "GET",
    "path": "/user/followers/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        }
      },
      "required": [
        "user_id",
        "continuation_token"
      ]
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Followers_post__user_followers_continuation",
    "description": "Continuation User's Followers",
    "method": "POST",
    "path": "/user/followers/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Followers_get__user_followers",
    "description": "User's Followers",
    "method": "GET",
    "path": "/user/followers",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Followers_post__user_followers",
    "description": "User's Followers",
    "method": "POST",
    "path": "/user/followers",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Following_Continuation_get__user_following_continuation",
    "description": "User's Following Continuation",
    "method": "GET",
    "path": "/user/following/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token",
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Following_Continuation_post__user_following_continuation",
    "description": "User's Following Continuation",
    "method": "POST",
    "path": "/user/following/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_get__user_tweets",
    "description": "User's Tweets",
    "method": "GET",
    "path": "/user/tweets",
    "parameters": {
      "type": "object",
      "properties": {
        "include_pinned": {
          "type": "boolean",
          "description": "include_pinned"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        },
        "username": {
          "type": "string",
          "description": "username"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_post__user_tweets",
    "description": "User's Tweets",
    "method": "POST",
    "path": "/user/tweets",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        },
        "include_pinned": {
          "type": "boolean",
          "description": "include_pinned"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_Continuation_get__user_tweets_continuation",
    "description": "User's Tweets Continuation",
    "method": "GET",
    "path": "/user/tweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_Continuation_post__user_tweets_continuation",
    "description": "User's Tweets Continuation",
    "method": "POST",
    "path": "/user/tweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_Details_get__user_details",
    "description": "User Details",
    "method": "GET",
    "path": "/user/details",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_Details_post__user_details",
    "description": "User Details",
    "method": "POST",
    "path": "/user/details",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_About_get__user_about",
    "description": "User About",
    "method": "GET",
    "path": "/user/about",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        }
      },
      "required": [
        "username"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_Continuation_get__tweet_replies_continuation",
    "description": "Tweet Replies Continuation",
    "method": "GET",
    "path": "/tweet/replies/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "continuation_token",
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_Continuation_post__tweet_replies_continuation",
    "description": "Tweet Replies Continuation",
    "method": "POST",
    "path": "/tweet/replies/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Favoriters_Continuation_get__tweet_favoriters_continuation",
    "description": "Tweet User Favoriters Continuation",
    "method": "GET",
    "path": "/tweet/favoriters/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "continuation_token",
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Retweets_Continuation_get__tweet_retweets_continuation",
    "description": "Tweet User Retweets Continuation",
    "method": "GET",
    "path": "/tweet/retweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        }
      },
      "required": [
        "continuation_token",
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Details_get__tweet_details",
    "description": "Tweet Details",
    "method": "GET",
    "path": "/tweet/details",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Details_post__tweet_details",
    "description": "Tweet Details",
    "method": "POST",
    "path": "/tweet/details",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Favoriters_get__tweet_favoriters",
    "description": "Tweet User Favoriters",
    "method": "GET",
    "path": "/tweet/favoriters",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Retweets_get__tweet_retweets",
    "description": "Tweet User Retweets",
    "method": "GET",
    "path": "/tweet/retweets",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_get__tweet_replies",
    "description": "Tweet Replies",
    "method": "GET",
    "path": "/tweet/replies",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_post__tweet_replies",
    "description": "Tweet Replies",
    "method": "POST",
    "path": "/tweet/replies",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Following_get__user_following",
    "description": "User's Following",
    "method": "GET",
    "path": "/user/following",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Following_post__user_following",
    "description": "User's Following",
    "method": "POST",
    "path": "/user/following",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Lists_Tweets_Continuation_get__lists_tweets_continuation",
    "description": "Lists Tweets Continuation",
    "method": "GET",
    "path": "/lists/tweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "list_id": {
          "type": "string",
          "description": "list_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      },
      "required": [
        "list_id",
        "continuation_token"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_Continuation_get__search_search_continuation",
    "description": "Search Continuation",
    "method": "GET",
    "path": "/search/search/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "end_date": {
          "type": "string",
          "description": "end_date"
        },
        "min_likes": {
          "type": "number",
          "description": "min_likes"
        },
        "start_date": {
          "type": "string",
          "description": "YYYY-MM-DD"
        },
        "min_replies": {
          "type": "number",
          "description": "min_replies"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "min_retweets": {
          "type": "number",
          "description": "min_retweets"
        },
        "section": {
          "type": "string",
          "description": "section"
        }
      },
      "required": [
        "continuation_token",
        "query"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_Continuation_post__search_search_continuation",
    "description": "Search Continuation",
    "method": "POST",
    "path": "/search/search/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "min_likes": {
          "type": "integer",
          "description": "min_likes"
        },
        "min_retweets": {
          "type": "integer",
          "description": "min_retweets"
        },
        "start_date": {
          "type": "string",
          "description": "start_date"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Topic_Classification_get__ai_topic_classification",
    "description": "Topic Classification",
    "method": "GET",
    "path": "/ai/topic-classification",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      },
      "required": [
        "text"
      ]
    }
  },
  {
    "name": "agntdata_x_Detect_post__translate_detect",
    "description": "Detect",
    "method": "POST",
    "path": "/translate/detect",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Named_Entity_Recognition_get__ai_named_entity_recognition",
    "description": "Named Entity Recognition",
    "method": "GET",
    "path": "/ai/named-entity-recognition",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      },
      "required": [
        "text"
      ]
    }
  },
  {
    "name": "agntdata_x_Sentiment_Analysis_get__ai_sentiment_analysis",
    "description": "Sentiment Analysis",
    "method": "GET",
    "path": "/ai/sentiment-analysis",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      },
      "required": [
        "text"
      ]
    }
  },
  {
    "name": "agntdata_x_Translate_post__translate",
    "description": "Translate",
    "method": "POST",
    "path": "/translate",
    "parameters": {
      "type": "object",
      "properties": {
        "dest": {
          "type": "string",
          "description": "dest"
        },
        "text": {
          "type": "string",
          "description": "text"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Available_Locations___Beta__get__trends_available",
    "description": "Available Locations (Beta)",
    "method": "GET",
    "path": "/trends/available",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "agntdata_x_Get_trends_near_a_location__Beta__get__trends",
    "description": "Get trends near a location (Beta)",
    "method": "GET",
    "path": "/trends/",
    "parameters": {
      "type": "object",
      "properties": {
        "woeid": {
          "type": "string",
          "description": "woeid"
        }
      },
      "required": [
        "woeid"
      ]
    }
  },
  {
    "name": "agntdata_x_Geo_Search___Beta__get__search_geo",
    "description": "Geo Search (Beta)",
    "method": "GET",
    "path": "/search/geo",
    "parameters": {
      "type": "object",
      "properties": {
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "range": {
          "type": "string",
          "description": "range"
        },
        "longitude": {
          "type": "string",
          "description": "longitude"
        },
        "latitude": {
          "type": "string",
          "description": "latitude"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_x_Lists_Tweets_get__lists_tweets",
    "description": "Lists Tweets",
    "method": "GET",
    "path": "/lists/tweets",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "list_id": {
          "type": "string",
          "description": "list_id"
        }
      },
      "required": [
        "list_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Lists_Details_get__lists_details",
    "description": "Lists Details",
    "method": "GET",
    "path": "/lists/details",
    "parameters": {
      "type": "object",
      "properties": {
        "list_id": {
          "type": "string",
          "description": "list_id"
        }
      },
      "required": [
        "list_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_get__search_search",
    "description": "Search",
    "method": "GET",
    "path": "/search/search",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "start_date": {
          "type": "string",
          "description": "YYYY-MM-DD"
        },
        "min_likes": {
          "type": "number",
          "description": "min_likes"
        },
        "min_retweets": {
          "type": "number",
          "description": "min_retweets"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "end_date": {
          "type": "string",
          "description": "end_date"
        },
        "min_replies": {
          "type": "number",
          "description": "min_replies"
        },
        "section": {
          "type": "string",
          "description": "section"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_post__search_search",
    "description": "Search",
    "method": "POST",
    "path": "/search/search",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "min_likes": {
          "type": "integer",
          "description": "min_likes"
        },
        "min_retweets": {
          "type": "integer",
          "description": "min_retweets"
        },
        "start_date": {
          "type": "string",
          "description": "start_date"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Hashtag_get__hashtag_hashtag",
    "description": "Hashtag",
    "method": "GET",
    "path": "/hashtag/hashtag",
    "parameters": {
      "type": "object",
      "properties": {
        "section": {
          "type": "string",
          "description": "section"
        },
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        }
      },
      "required": [
        "hashtag"
      ]
    }
  },
  {
    "name": "agntdata_x_Hashtag_post__hashtag_hashtag",
    "description": "Hashtag",
    "method": "POST",
    "path": "/hashtag/hashtag",
    "parameters": {
      "type": "object",
      "properties": {
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Hashtag_Continuation_get__hashtag_hashtag_continuation",
    "description": "Hashtag Continuation",
    "method": "GET",
    "path": "/hashtag/hashtag/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        }
      },
      "required": [
        "continuation_token",
        "hashtag"
      ]
    }
  },
  {
    "name": "agntdata_x_Hashtag_Continuation_post__hashtag_hashtag_continuation",
    "description": "Hashtag Continuation",
    "method": "POST",
    "path": "/hashtag/hashtag/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  }
]

Example

curl -X GET 'https://api.agntdata.dev/v1/x/' \
  -H 'Authorization: Bearer $AGNTDATA_API_KEY'

Use Cases

  • Social and creator intelligence agents using X
  • Marketing and research teams monitoring accounts and content
  • Product teams building alerts, digests, and dashboards
  • Developers prototyping LLM tools that need live network data
  • Data teams joining X signals with CRM or warehouse data

Other Platforms

agntdata provides unified access to social data across multiple platforms. Explore other available APIs:

curl https://api.agntdata.dev/v1/platforms

Available platforms: LinkedIn, YouTube, TikTok, X, Instagram, Reddit, Facebook. Each uses the same API key and follows the same patterns.

Links

安全使用建议
This skill appears to do exactly what it claims: call agntdata's X (Twitter) API using a single AGNTDATA_API_KEY. Before installing, verify you trust agntdata (https://api.agntdata.dev / https://app.agntdata.dev) because your API key will give that service access to requested social data. Do not include secrets or proprietary details in the activation "useCase" text. If you plan to install the optional plugin, review that plugin's npm package and permissions separately. Use least-privilege API keys when possible and rotate/delete keys you no longer need.
功能分析
Type: OpenClaw Skill Name: agntdata-x Version: 1.0.13 The agntdata-x skill is a standard API integration for accessing X (Twitter) data via the agntdata.dev platform. It defines a comprehensive set of tools for social listening and data retrieval, requiring a user-provided API key (AGNTDATA_API_KEY) and the curl utility as specified in SKILL.md. No evidence of malicious intent, data exfiltration, or unauthorized execution was found; the code and instructions are consistent with the stated purpose of providing a unified social media data interface.
能力标签
requires-oauth-tokenrequires-sensitive-credentials
能力评估
Purpose & Capability
Name/description say this is an agntdata wrapper for X/Twitter data; declared requirements (curl and AGNTDATA_API_KEY) and the SKILL.md endpoints all match that purpose and are expected for this integration.
Instruction Scope
SKILL.md confines actions to calling agntdata endpoints (discovery, register, and data endpoints). One minor privacy note: the activation/register call asks you to supply a free-form "useCase" string — avoid putting sensitive or proprietary info there, as it will be sent to api.agntdata.dev.
Install Mechanism
Instruction-only skill with no install spec or downloaded code; lowest-risk install profile. Optional plugin references point to an npm package but are clearly labeled optional.
Credentials
Only requests a single primary credential (AGNTDATA_API_KEY) which directly matches the declared API; no unrelated secrets or config paths are requested.
Persistence & Privilege
Does not request always: true, does not modify other skills or system configs, and runs only when invoked. No elevated persistence or cross-skill privileges are requested.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install agntdata-x
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /agntdata-x 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.13
agntdata-x v1.0.13 - Version bump from 1.0.12 to 1.0.13 for maintenance and metadata update. - No new features or endpoint changes. - Documentation and metadata files updated.
v1.0.12
- Updated homepage link in the skill metadata to the latest agntdata X API documentation. - Bumped skill version from 1.0.11 to 1.0.12.
v1.0.11
agntdata-x 1.0.11 - Version bump from 1.0.10 to 1.0.11. - Documentation updated; no functional or API changes.
v1.0.10
agntdata-x 1.0.10 - Version bump to 1.0.10. - No functional changes; documentation and metadata update only.
v1.0.9
Version 1.0.9 - Updated to version 1.0.9 in SKILL.md. - API discovery endpoint documentation corrected: endpoint example now omits "credit costs" for accuracy. - No changes to the actual API endpoints or schemas; description and documentation clarified.
v1.0.7
agntdata-x 1.0.7 changelog: - Improved documentation for X (Twitter) API endpoints, capabilities, and setup. - Added detailed guidance for authentication and API key activation flows. - Listed all available endpoints and their JSON tool schema parameters. - Recommended using the OpenClaw plugin for best experience, but clarified skill use for plugin-incompatible environments.
元数据
Slug agntdata-x
版本 1.0.13
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 6
常见问题

X (Twitter) API 是什么?

X (Twitter) API integration with a single agntdata API key (Bearer token). Read tweets, user profiles, followers, search, lists, trends, and hashtags. Use th... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 142 次。

如何安装 X (Twitter) API?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install agntdata-x」即可一键安装,无需额外配置。

X (Twitter) API 是免费的吗?

是的,X (Twitter) API 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

X (Twitter) API 支持哪些平台?

X (Twitter) API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 X (Twitter) API?

由 Jaen(@jaencarrodine)开发并维护,当前版本 v1.0.13。

💬 留言讨论