> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AIsa Twitter API

> 读取 X/Twitter 资料、时间线、推文、趋势和社区。

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/aisa-twitter-api)

AIsa Twitter API Skill 为 Agent 提供统一的 X/Twitter 读取能力，用于资料查询、时间线分析、推文搜索、趋势监控和社区研究。

## 安装

```bash theme={null}
npm install -g @aisa-one/cli
aisa skills install aisa-twitter-api
```

## Agent 可以做什么？

<CardGroup cols={2}>
  <Card title="用户情报" icon="user">
    查询账号资料、简介、关注者、关注列表、验证关注者和最新推文。
  </Card>

  <Card title="推文检索" icon="magnifying-glass">
    搜索推文、获取 replies、quotes、retweeters 和 thread context。
  </Card>

  <Card title="趋势与社区" icon="chart-line">
    查询 trends、lists、communities 和 Spaces。
  </Card>

  <Card title="研究工作流" icon="clipboard-list">
    将结果整理成竞品、舆情、影响者或市场研究报告。
  </Card>
</CardGroup>

## 何时使用

* 需要读取 X/Twitter 公共数据。
* 需要跟踪账号、话题、社群、趋势或传播链。
* 需要将社交数据与新闻、市场或研究数据交叉验证。

## 何时不要使用

* 不要把单条推文当作事实结论。
* 不要绕过授权或平台规则。
* 发帖、点赞、关注等写操作必须使用授权流程，不能默认执行。

## 快速参考

```bash theme={null}
export AISA_API_KEY="YOUR_AISA_API_KEY"
```

常见请求：

```txt theme={null}
查一下 @AIsaOneHQ 最近的推文和主要话题
搜索最近关于某个产品发布的热门推文
总结某个社区里对一个项目的正反观点
```

## 能力

* 用户资料和简介
* 用户最新推文、mentions、followers、followings
* tweet advanced search
* replies、quotes、retweeters、thread context
* trends、lists、communities、Spaces

## 高意图工作流

1. 明确研究对象：账号、关键词、社区或事件。
2. 读取相关推文和上下文。
3. 聚合互动、时间、账号影响力和观点。
4. 输出带来源链接的简报。
5. 对事实性判断提示仍需二次验证。

## 安全说明

把 Twitter/X 信号作为社交证据或情绪信号。涉及投资、法律、医疗或安全判断时，需要与官方来源或其他数据交叉验证。

## 相关

<CardGroup cols={3}>
  <Card title="Twitter Autopilot" icon="x-twitter" href="/zh/agent-skills/twitter-autopilot">
    更完整的 X/Twitter 自动化能力。
  </Card>

  <Card title="Post & Engage" icon="paper-plane" href="/zh/agent-skills/aisa-twitter-post-engage">
    授权后的发布和互动流程。
  </Card>

  <Card title="X Intelligence Automation" icon="binoculars" href="/zh/agent-skills/x-intelligence-automation">
    监控竞品、影响者和趋势。
  </Card>
</CardGroup>