X 资料读取 Dee3526/dsh-plugin-x-profile-reader

dsh-plugin-x-profile-reader

一个 DeepSeek Harness (DSH) 插件，新增了 x_profile_read 工具：通过 Apify 第三方爬虫读取某个 X（Twitter）用户的公开个人资料和近期帖子，并规范化为事实性的结构化结果。

为 x-outreach-agent 预设而构建，但任何添加了该工具行的预设都可以挂载它。

数据来源： 本插件通过第三方 actor（patient_discovery/twitter-user-tweets）抓取 X —— 并非官方 X API。仅限公开、免登录数据。参见数据来源。

前置条件

- 一个 DeepSeek Harness 配置文件。
- 一个 Apify 账户和 API 令牌（apify.com → Settings → Integrations → API token）。

安装

dsh plugin --profile add dsh-plugin-x-profile-reader

或从本地检出安装：
dsh plugin --profile add ./path/to/dsh-plugin-x-profile-reader

配置你自己的 API 密钥

插件从 harness 凭据存储中读取其凭据，引用名为 APIFY_TOKEN（可通过 tokenRef 配置）。本包中不捆绑任何密钥 —— 每位用户都需提供自己的密钥。

最简单的方式 —— 在启动前导出：

export APIFY_TOKEN=apify_api_your_token_here
dsh web

你也可以通过 harness 凭据设置来存储它；无论哪种方式，该值都会在调用时解析，绝不会写入插件中。

在预设中挂载该工具

在预设的 agent.cordis.yml 中添加一行：

- id: tool-x-profile
name: dsh-plugin-x-profile-reader
config: # 可选 actorId: XSXdgwgBakXd5vRxB # 默认 Apify actor tokenRef: APIFY_TOKEN # 默认凭据引用

该行会使用宿主 credentials + subprocess，且不发布任何服务，因此不需要 isolate 领域。

用法

调用 x_profile_read 工具：

| 输入 | 类型 | 默认值 | 说明 |
| username | string（必填） | — | 不带 @ 的用户名，或个人资料 URL |
| lookbackDays | integer | 30 | 限制在 1–30 |
| maxPosts | integer | 20 | 限制在 1–100 |
| includeReplies | boolean | false | 尽力而为（数据源没有明确的回复标志） |
| includeReposts | boolean | false | 为 false 时排除 RT @ 帖子 |

输出：

{ ok, user, posts[], meta, dataMissing[], restrictions[] }

- user —— 公开个人资料（id、username、name、avatar、verified、followers 等）。
- posts[] —— 规范化后的帖子，每条包含 text、url、publishedAt、type（original/reply/repost）以及可用的 metrics。
- dataMissing[] / restrictions[] —— 明确说明的缺失数据和权限/速率限制说明。

该工具仅返回事实性数据 —— 它不会推断主题或销售意图；这种综合归纳属于 agent/预设层的职责。

数据来源

- Actor：patient_discovery/twitter-user-tweets（userId + maxPages）。
- 公开、免登录抓取 —— 并非官方 X API。
- 已知限制：个人资料字段不完整（bio/location/加入时间/关注数/推文数不可用），并且没有明确的回复标志。
- 遵守 X 的条款和速率限制；负责任地使用。

许可证

MIT