kiro-x-hot-publisher

发现 X 上的热门话题，逐一丰富推文，对信号进行评分和总结，生成一份推文草稿，并可选择按计划发布。

# Kiro X Hot Publisher

Plugin producer: `kiroai.io`

End-to-end X workflow for Kiro:

1. Discover trending tweets from X API
2. Enrich each candidate via FxTwitter (full text/article support)
3. Score and rank (engagement + freshness)
4. Summarize key signals
5. Generate exactly one tweet draft
6. Optionally publish via X API (OAuth 1.0a)

## Files

- `scripts/x_hot_pipeline.py`
- `examples/cron_command.txt`

## Required env vars

Search:

- `X_BEARER_TOKEN` (recommended)

Publish (optional, only when `--post`):

- `X_API_KEY`
- `X_API_SECRET`
- `X_ACCESS_TOKEN`
- `X_ACCESS_TOKEN_SECRET`

## Quick start

```bash
python3 skills/kiro-x-hot-publisher/scripts/install_and_init.py

python3 skills/kiro-x-hot-publisher/scripts/x_hot_pipeline.py \
  --queries "AI,OpenAI,DeepSeek,Claude,Gemini" \
  --batch-size 10
```

Post directly:

```bash
python3 skills/kiro-x-hot-publisher/scripts/x_hot_pipeline.py \
  --queries "AI,OpenAI,DeepSeek" \
  --batch-size 10 \
  --post
```

## Output

Default output folder: `./outputs/x-hot/`

Generated files:

- `latest.json`: full structured result
- `latest.txt`: plain-text briefing + final tweet draft

## Notes

- This workflow is designed for public tweets only.
- FxTwitter is a third-party dependency for enrichment; if unavailable, base X data is still used.
- Keep `--batch-size` small initially (recommended `10`).


## Changelog

- 1.1.0: Security hardening for `scripts/setup_cron.sh` (input validation and command construction safeguards).

---

## 中文说明

# Kiro X Hot Publisher

插件生产者：`kiroai.io`

面向 Kiro 的端到端 X 工作流：

1. 从 X API 发现热门推文
2. 通过 FxTwitter 丰富每个候选项（支持完整文本/文章）
3. 评分与排名（互动度 + 新鲜度）
4. 总结关键信号
5. 精确生成一份推文草稿
6. 可选地通过 X API 发布（OAuth 1.0a）

## 文件

- `scripts/x_hot_pipeline.py`
- `examples/cron_command.txt`

## 所需环境变量

搜索：

- `X_BEARER_TOKEN`（推荐）

发布（可选，仅在使用 `--post` 时）：

- `X_API_KEY`
- `X_API_SECRET`
- `X_ACCESS_TOKEN`
- `X_ACCESS_TOKEN_SECRET`

## 快速开始

```bash
python3 skills/kiro-x-hot-publisher/scripts/install_and_init.py

python3 skills/kiro-x-hot-publisher/scripts/x_hot_pipeline.py \
  --queries "AI,OpenAI,DeepSeek,Claude,Gemini" \
  --batch-size 10
```

直接发布：

```bash
python3 skills/kiro-x-hot-publisher/scripts/x_hot_pipeline.py \
  --queries "AI,OpenAI,DeepSeek" \
  --batch-size 10 \
  --post
```

## 输出

默认输出文件夹：`./outputs/x-hot/`

生成的文件：

- `latest.json`：完整的结构化结果
- `latest.txt`：纯文本简报 + 最终推文草稿

## 注意事项

- 此工作流仅针对公开推文设计。
- FxTwitter 是用于内容丰富的第三方依赖；若不可用，仍会使用基础的 X 数据。
- 初期请保持 `--batch-size` 较小（推荐 `10`）。


## 更新日志

- 1.1.0：对 `scripts/setup_cron.sh` 进行安全加固（输入验证和命令构造的防护措施）。