内容
# 工具列表
[官方 SentiSift 客户端库](https://sentisift.com) 用于评论审核和智能 API。三个已发布的软件包，均为开源集成代码，开发者可以阅读、审核和贡献。
| 软件包 | 源代码 | 注册表 | 安装 |
|---|---|---|---|
| `sentisift` (Python) | [`python/`](python/) | [PyPI](https://pypi.org/project/sentisift/) | `pip install sentisift` |
| `@sentisift/client` (Node/TypeScript) | [`node/`](node/) | [npm](https://www.npmjs.com/package/@sentisift/client) | `npm install @sentisift/client` |
| `sentisift-mcp` (MCP 服务器) | [`mcp/`](mcp/) | [PyPI](https://pypi.org/project/sentisift-mcp/) | `uvx sentisift-mcp` |
## 什么是 SentiSift？
SentiSift 过滤评论区中的机器人、垃圾信息和噪音，而不压制真实的声音。它在五个独立的轴上评估每个评论（情感、优雅度、长度、行为模式、商业信号），并返回审核决策和人群级分析。在付费层级上，它还会在讨论偏向一方时提供建设性的观点（“影响力”）。
在 [sentisift.com/pricing](https://sentisift.com/pricing.html) 获取免费的 API 密钥（1,000 条评论，无需信用卡）。完整的 API 参考：[sentisift.com/api-docs.html](https://sentisift.com/api-docs.html).
## 快速开始
### Python
```bash
pip install sentisift
```
```python
from sentisift import SentiSift
client = SentiSift() # 从环境变量中读取 SENTISIFT_API_KEY
result = client.analyze(
article_url="https://example.com/article/1",
comments=[
{"text": "Great article!", "author": "alice", "time": "2026-04-18T10:00:00"},
],
)
```
### Node / TypeScript
```bash
npm install @sentisift/client
```
```typescript
import { SentiSift } from "@sentisift/client";
const client = new SentiSift();
const result = await client.analyze({
articleUrl: "https://example.com/article/1",
comments: [{ text: "Great article!", author: "alice", time: "2026-04-18T10:00:00" }],
});
```
### MCP (Claude Desktop, Cursor, VS Code, Continue)
```bash
uvx sentisift-mcp # 通过 uv 进行一次性运行
# 或
pip install sentisift-mcp # 然后添加到您的 MCP 主机配置中
```
然后将 SentiSift 条目添加到您的主机的 MCP 配置中（Claude Desktop 的 `claude_desktop_config.json`，Cursor 的 `~/.cursor/mcp.json`，VS Code 的 `settings.json` 等）。有关主机特定代码段，请参见 [`mcp/README.md`](mcp/README.md).
## 仓库布局
```
.
├── python/ Python SDK（PyPI 上的 sentisift）
├── node/ Node SDK（npm 上的 @sentisift/client）
├── mcp/ MCP 服务器（PyPI 上的 sentisift-mcp）
├── OVERVIEW.md 端点覆盖矩阵、支持的平台、发布历史
├── RELEASE_RUNBOOK.md AI 驱动的发布过程（阅读此内容以进行任何版本更新）
├── RELEASE_CHECKLIST.md 工程逐行检查清单
└── .gitlab-ci.yml CI：每次推送都进行测试；标签推送时发布
```
## 版本控制
所有三个软件包都遵循 [Semantic Versioning](https://semver.org/). 1.0 之前的次要版本可能包含破坏性更改。每个软件包的 CHANGELOG.md 文件记录了每个版本。
## 贡献
通过 [issues](https://gitlab.com/pickel-fintech/sentisift-sdks/-/issues) 欢迎提交错误报告和功能请求。对于拉取请求，请先打开一个问题来讨论更改。
## 架构
完整的 SentiSift API 服务（身份验证、计费、评分管道、爬虫）位于一个单独的私有仓库中。该公共仓库仅包含面向客户端的软件包及其集成代码、OpenAPI 派生模型和测试。
文档托管在 [sentisift.com](https://sentisift.com)：
- HTML 参考：[api-docs.html](https://sentisift.com/api-docs.html)
- LLM 友好 Markdown 镜像：[api-docs.md](https://sentisift.com/api-docs.md)
- OpenAPI 3.1 规范：[openapi.json](https://sentisift.com/openapi.json)
- AI 代理集成指南：[AGENTS.md](https://sentisift.com/AGENTS.md)
- llmstxt.org 索引：[llms.txt](https://sentisift.com/llms.txt)
## 许可证
本仓库中的 SDK 源代码 **MIT 许可** — 参见 [LICENSE](LICENSE). SentiSift API 服务本身是一个单独的托管服务，由 [sentisift.com/terms.html](https://sentisift.com/terms.html) 上的服务条款管辖。使用 API 需要从 [sentisift.com/pricing](https://sentisift.com/pricing.html) 获取 API 密钥。
## 联系方式
- 总体：[tom@sentisift.com](mailto:tom@sentisift.com)
- 客户支持：[support@sentisift.com](mailto:support@sentisift.com)
- 问题：[GitLab issues](https://gitlab.com/pickel-fintech/sentisift-sdks/-/issues)
