hogan-tech/brand-loom
GitHub: hogan-tech/brand-loom
brand-loom 是一个模型无关的开源营销技能库,通过统一的 Python 和命令行接口,在任何 LLM 上生成标题、文案、SEO 大纲、FAQ 等品牌感知内容。
Stars: 20 | Forks: 2
# brand-loom
**开源的营销技能,可运行于任何模型 — 搭配托管的品牌记忆引擎。无需编码代理。**
[](LICENSE)
[](https://pypi.org/project/brand-loom/)
[](https://github.com/hogan-tech/brand-loom/actions/workflows/ci.yml)
`brand-loom` 是一个小型的**通用营销技能**库 —— 包含引子、文案、标签、内容
再利用、SEO 大纲、FAQ、schema.org 标记、CTA —— 可运行于**任何 LLM**(OpenAI、Anthropic、Gemini,
或通过 Ollama 运行的本地模型)。自带 API key(BYOK)。无需编码代理,无供应商锁定。
## 为什么选择 brand-loom
- **模型无关。** 统一接口,支持四家供应商,支持 BYOK。仅需修改一个环境变量即可切换模型。
- **无需编码代理。** 纯 Python 实现 —— 不依赖 Claude Code / Cursor / OpenClaw。
- **品牌感知接口。** 每个技能都接受可选的 `brand_context`。在此提供基础默认值;即可在托管的 Neoxra 上
获得自动提取的品牌语调。
## 快速开始(60 秒,无需 API key)
```
pip install brand-loom
```
```
from brand_loom.providers import use_provider
from brand_loom.skills.hook import HookSkill
use_provider("fake") # runs with zero keys; swap for "openai"/"anthropic"/"gemini"/"ollama"
skill = HookSkill()
print(skill.run_topic("How we cut cloud costs 40%"))
```
真实供应商 (BYOK):
```
pip install "brand-loom[openai]"
export OPENAI_API_KEY=sk-...
export BRANDLOOM_PROVIDER=openai
```
作为代理运行(无需编码代理):
```
brand-loom run hook --text "How we cut cloud costs 40%"
brand-loom chain hook,caption --text "How we cut cloud costs 40%" --brand brand.json
```
一个轻量级、线性的运行器 —— 支持在任意模型上运行单个技能或简单链。复杂的多平台编排
(语调匹配,Planner→Critic,自动扩散)位于托管的 **[Neoxra](https://neoxra.com)** 中。
代理链(Python API):
```
from brand_loom.agent import run_chain, run_skill
from brand_loom.providers import use_provider
use_provider("fake") # or "openai", "anthropic", "gemini", "ollama"
# 单一技能
result = run_skill("hook", "How we cut cloud costs 40%")
print(result.text)
# Chain:hook → caption
result = run_chain(["hook", "caption"], "How we cut cloud costs 40%")
print(result.text)
# 带 brand 上下文
result = run_skill("hook", "AI marketing", brand_context={
"tone": ["bold", "witty"],
"audience": "startup founders",
})
print(result.text)
```
## 在你的编码代理中安装
brand-loom 也可以作为 Claude Code、Cursor、OpenClaw 以及任何兼容
[skills.sh](https://skills.sh) 的宿主的代理技能使用:
```
npx skills add hogan-tech/brand-loom
```
每个技能都作为 `SKILL.md` 存放在 `skills/` 目录中,包含代理宿主会自动
解析的 frontmatter。无需配置 —— 安装即可使用。
## 技能 (v0.1)
| 技能 | 功能 |
|---|---|
| `hook` | 针对某个主题的标题 / 引子选项 |
| `caption` | 基于主题 + `brand_context` 生成平台文案 |
| `hashtags` | 相关且去重的标签集合 |
| `repurpose` | 长转短、文章转长推文(Thread)、文章转轮播文案 |
| `seo_outline` | 4–8 个段落的 SEO 文章大纲(支持区域参数) |
| `faq` | 从正文中提取 3–6 个问答对 |
| `schema_org` | 生成 FAQPage / Article / Breadcrumb JSON-LD(不使用 LLM) |
| `cta` | 针对特定目标的行动号召 (CTA) 变体 |
## 供应商
| 供应商 | 额外依赖 | 环境变量 |
|---|---|---|
| OpenAI | `brand-loom[openai]` | `OPENAI_API_KEY` |
| Anthropic | `brand-loom[anthropic]` | `ANTHROPIC_API_KEY` |
| Gemini | `brand-loom[gemini]` | `GEMINI_API_KEY` |
| Ollama(本地) | 内置 (HTTP) | `OLLAMA_HOST` |
| Fake(测试/演示) | 内置 | — |
## brand_context 接口
各项技能接受可选的 `brand_context` 字典(`tone`、`audience`、`do_phrases`、`avoid_phrases`)。`brand-loom`
内置了一个空/基础的默认值。从现有内容中自动提取语调、多平台扩散以及
无代码 UI 均位于托管的 **[Neoxra](https://neoxra.com)** 中 —— 参见 [HOSTED.md](HOSTED.md)。
## 贡献
欢迎提交 PR —— 请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)、[SCOPE.md](SCOPE.md),并签署
[CLA](CLA.md)。在项目范围内:单次执行的通用技能。不在项目范围内:语调引擎、编排、经过调优的评分器、
分析/发布集成(这些位于托管产品中)。
## 许可证
[Apache-2.0](LICENSE)。由 [Neoxra](https://neoxra.com) 提供 · Meridian Global 旗下产品。
标签:AI应用, AI风险缓解, LLM工具, Petitpotam, Python, SEO优化, 开源, 无后门, 营销内容生成, 逆向工具