软件包 SEO 技能

适用于 npm 包、GitHub 仓库和 AI 智能体技能的最佳 SEO 实践。最大化可发现性。

作者: Next Frontier
版本： 1.0.0
标签： seo, npm, github, 发布, 营销, 可发现性, 软件包

使用时机

在以下情况使用此技能：
- 发布新的 npm 包时
- 创建 GitHub 仓库时
- 向 ClawdHub 提交技能时
- 更新描述/README 以提升可发现性时
- 审计现有软件包以改进 SEO 时

热门关键词 (2026)

务必包含此列表中的相关术语：

AI, 自动化, 氛围编程, cursor, claude, gpt, copilot, 智能体,
自主, mcp, langchain, llm, 测试, 开发工具, cli, typescript,
python, react, nextjs, api, sdk, 工具, 框架, openai, anthropic,
编程助手, AI 助手, 开发者工具, 生产力

专业建议： 发布前查看 X/Twitter 上的科技趋势，获取最新术语。

npm 软件包

package.json

{
  "name": "描述性且利于SEO的名称",
  "description": "清晰的价值主张并包含关键词。用于 Y 的 AI 驱动 X。兼容 Cursor、Claude、GPT。",
  "keywords": [
    "ai",
    "automation",
    "claude",
    "gpt",
    "cursor",
    "vibe-coding",
    "agent",
    "cli",
    "devtools",
    "mcp",
    "langchain",
    "copilot",
    "testing",
    "typescript",
    "openai",
    "anthropic"
  ],
  "repository": {
    "type": "git",
    "url": "https://github.com/org/repo"
  },
  "homepage": "https://github.com/org/repo#readme",
  "bugs": {
    "url": "https://github.com/org/repo/issues"
  }
}

规则：
- 至少 10-15 个关键词
- 描述在 200 字符以内但富含关键词
- 包含仓库、主页、问题反馈的 URL
- 名称应易于搜索（避免晦涩的名称）

README.md 结构

# 软件包名称

[![npm 版本](https://img.shields.io/npm/v/package-name.svg)](https://npmjs.com/package/package-name)
[![npm 下载量](https://img.shields.io/npm/dm/package-name.svg)](https://npmjs.com/package/package-name)
[![许可证](https://img.shields.io/npm/l/package-name.svg)](LICENSE)

> 包含关键词的单行描述。用于 Y 的 AI 驱动 X。

## 兼容平台

- 🤖 Claude / Claude Code
- 🔵 Cursor
- 💚 GPT / ChatGPT
- ⚡ Copilot
- 🧩 MCP 服务器

## 安装

\`\`\`bash
npm install package-name
\`\`\`

## 快速开始

\`\`\`typescript
// 最小工作示例
\`\`\`

## 特性

- ✅ 包含关键词的特性 1
- ✅ 包含关键词的特性 2
- ✅ 包含关键词的特性 3

## API / 用法

[详情...]

## 许可证

MIT

关键要素：
- 徽章置于最顶部
- 包含关键词的醒目标语
- “兼容平台”部分（展示兼容性）
- 安装命令位于首屏可见区域
- 快速开始代码示例
- 带复选框的特性列表

GitHub 仓库

描述 (350 字符以内)

格式：

[功能描述]。[核心优势]。[兼容性]。[行动号召]。

示例：

用于法律文档和融资演讲稿的 AI 驱动 PDF 生成器。根据提示创建 SAFE、NDA、条款清单。兼容 Claude、Cursor、GPT。无需模板。

为 AI 智能体提供的实时金融数据 API。股票、加密货币、外汇、ETF 统一数据源。120+ 个端点。Alpha Vantage 的替代方案。

使用 AI 对 Web 应用进行自动化质量保证。冒烟测试、可访问性检查、视觉回归测试。即插即用的 CI/CD 测试。兼容 Playwright。

主题 (GitHub 标签)

添加 10-20 个相关主题：

ai, automation, claude, gpt, cursor, typescript, cli, devtools,
agent, testing, api, sdk, mcp, langchain, openai, anthropic,
developer-tools, productivity, automation-tools

README

与 npm 的 README 保持一致 — 保持完全相同！

ClawdHub 技能

SKILL.md 描述

# 技能名称

> 包含关键词的单行描述。为 AI 智能体提供的 [功能描述]。兼容 Clawdbot、Claude、Cursor。

**作者:** 你的名字
**版本：** X.Y.Z
**标签：** tag1, tag2, tag3, ai, agent, automation

标签

包含 5-10 个标签：

ai, agent, automation, claude, cursor, mcp, cli, [领域特定标签]

同步检查清单

以下三项必须匹配：

发布前检查清单

每次发布前检查：

• [ ] 名称具有描述性且易于搜索
• [ ] 描述包含价值主张和 3-5 个关键词
• [ ] package.json 中有 10-15 个关键词
• [ ] README 包含徽章（版本、下载量、许可证）
• [ ] README 包含“兼容平台”部分
• [ ] README 在首屏可见区域有安装命令
• [ ] README 有快速开始代码示例
• [ ] GitHub 主题已添加（10-20 个）
• [ ] GitHub 描述与 npm 描述匹配
• [ ] 已检查 X/Twitter 趋势以获取最新术语
• [ ] 所有平台上的描述均已同步

徽章生成器

使用 shields.io：

[![npm 版本](https://img.shields.io/npm/v/PACKAGE.svg)](https://npmjs.com/package/PACKAGE)
[![npm 下载量](https://img.shields.io/npm/dm/PACKAGE.svg)](https://npmjs.com/package/PACKAGE)
[![许可证](https://img.shields.io/npm/l/PACKAGE.svg)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/ORG/REPO.svg)](https://github.com/ORG/REPO)

反面模式 (避免)

❌ 晦涩或过于“聪明”但不易搜索的名称
❌ 不包含关键词的描述
❌ 为空或极简的关键词数组
❌ 没有徽章的 README
❌ 没有“兼容平台”部分
❌ npm/GitHub/ClawdHub 描述不匹配
❌ 没有快速开始示例
❌ 在安装命令前有大段文字

优秀示例

ai-pdf-builder:

用于法律文档、融资演讲稿和报告的 AI 驱动 PDF 生成器。
根据提示创建 SAFE、NDA、条款清单、白皮书。
兼容 Claude、GPT、Cursor 和 AI 编程助手。几秒钟生成 YC 风格文档。

web-qa-bot:

使用 AI 对 Web 应用进行自动化质量保证。冒烟测试、可访问性检查、视觉回归测试。
手动 QA 的即插即用替代方案。
兼容 Playwright、Cursor、Claude。无需 QA 团队的 QA。

快速参考