hogan-tech/brand-loom

GitHub: hogan-tech/brand-loom

brand-loom 是一个模型无关的开源营销技能库,通过统一的 Python 和命令行接口,在任何 LLM 上生成标题、文案、SEO 大纲、FAQ 等品牌感知内容。

Stars: 20 | Forks: 2

# brand-loom **开源的营销技能,可运行于任何模型 — 搭配托管的品牌记忆引擎。无需编码代理。** [![许可证](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![PyPI](https://img.shields.io/pypi/v/brand-loom.svg)](https://pypi.org/project/brand-loom/) [![CI](https://static.pigsec.cn/wp-content/uploads/repos/cas/ad/ad5834178f7599af9fdda11629d49cae07f2997beec49821b2920eff5bfd50e7.svg)](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优化, 开源, 无后门, 营销内容生成, 逆向工具