/docs
pSEO Wizard 使用文档
从网站到已发布页面所需的一切:向导如何工作,如何不写代码把页面放到您的网站上,以及遇到问题时该怎么办。
最后更新:2026 年 9 月
/how-it-works
使用方法
向导共五步。付款前,您可以随时返回修改任何一步。
- 01
粘贴网站地址
我们会读取您的首页和几个关键页面(服务、价格、菜单、关于我们、联系方式),并识别您的业务类型。您还可以添加希望每个页面都使用的关键信息。
- 02
选择模式
选择搜索词的形式,例如“{城市}的{服务}”或“适合{人群}的{产品}”,再选择一个页面模板。
- 03
填写取值
列出要组合的服务、城市或人群,每个组合就是一个页面。如果目标是地点,我们会检查它们是否符合您服务客户的方式。
- 04
生成
先生成免费页面。满意后再为其余页面付款(至少 10 页),页面会逐一生成。
- 05
发布或下载
把页面发送到 WordPress、Shopify、Webflow 或 WooCommerce,或下载为可直接上传的 HTML 文件。
/html-export
下载页面
在第 5 步点击“下载包”,会得到一个 ZIP 压缩包,里面包含把页面托管到任何地方所需的一切:
dist/每个页面一个现成的 HTML 文件,样式已内置,无需其他文件即可正常显示。dist/index.html一个列出所有页面并带链接的简单列表。sitemap.xml可以提交到 Google Search Console 的站点地图。data/同样的页面的 JSON 格式(标题、slug、元描述和 HTML),供开发者使用。
上线步骤
- 解压文件。
- 把 dist/ 里的文件上传到您的主机,最好放在 /blog 文件夹中,例如通过主机的文件管理器或 FTP。
- 在浏览器中打开一个页面检查效果,然后在 Google Search Console 中提交 sitemap.xml。
/json
面向开发者的 JSON
下载包里还有页面的数据形式,方便您从自己的应用中输出页面。data/wizard-data.json 是一个数组,每个页面对应一个对象:
| 字段 | 类型 | 内容 |
|---|---|---|
title | string | 显示在搜索结果中的页面标题,最多 60 个字符。 |
meta_description | string | 显示在搜索结果标题下方的元描述。 |
h1 | string | 页面的主标题。 |
body_html | string | 完整的 HTML 文档:head、内联 CSS、结构化数据和“延伸阅读”链接。请原样输出。 |
slug | string | 页面网址的最后一部分,例如 plumber-in-camden。 |
keywords | object | 生成此页面所用的取值,模式中的每个变量对应一个。 |
status | string | 导出中的页面始终为“success”。 |
locale | string | 页面的语言代码,例如 en 或 ar。 |
data/content.json 包含同样的页面,并额外提供一些工具需要的三个字段名:content(与 body_html 相同),以及 metaDescription 和 description(都与 meta_description 相同)。
页面对象示例(body_html 已省略)
{
"title": "Plumber in Camden | Example Plumbing",
"meta_description": "Same-day plumbing in Camden: boiler service from £89 and leak repairs by Gas Safe registered engineers.",
"h1": "Plumber in Camden",
"body_html": "<!DOCTYPE html><html lang=\"en\" dir=\"ltr\"><head>…</head><body>…</body></html>",
"slug": "plumber-in-camden",
"keywords": { "Service": "Plumber", "Area": "Camden" },
"status": "success",
"locale": "en"
}从您的应用输出页面
把 body_html 作为该页面网址的完整响应返回。不要把它放进您自己的布局里:它已经包含 head、样式和结构化数据。请选择适合您技术栈的示例:
静态托管(无框架)
# Put the exported pages under /blog on any static host
unzip your-site-bundle.zip -d export
mkdir -p public/blog
cp export/dist/*.html public/blog/
# /blog/plumber-in-camden.html works now. For /blog/plumber-in-camden,
# turn on "clean URLs" (Netlify, Vercel, Cloudflare Pages) or, on nginx:
location /blog/ {
try_files $uri $uri.html =404;
}Next.js
import pages from '@/data/wizard-data.json';
export async function GET(_req: Request, { params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params;
const page = pages.find(p => p.slug === decodeURIComponent(slug));
if (!page) return new Response('Not found', { status: 404 });
return new Response(page.body_html, {
headers: { 'Content-Type': 'text/html; charset=utf-8' }
});
}Astro
---
import pages from '../../data/wizard-data.json';
export function getStaticPaths() {
return pages.map(page => ({ params: { slug: page.slug }, props: { page } }));
}
const { page } = Astro.props;
---
<Fragment set:html={page.body_html} />Nuxt
import pages from '~~/data/wizard-data.json';
export default defineEventHandler((event) => {
const slug = decodeURIComponent(getRouterParam(event, 'slug') ?? '');
const page = pages.find(p => p.slug === slug);
if (!page) throw createError({ statusCode: 404 });
setHeader(event, 'Content-Type', 'text/html; charset=utf-8');
return page.body_html;
});PHP (Laravel)
use Illuminate\Support\Facades\Route;
Route::get('/blog/{slug}', function (string $slug) {
$pages = json_decode(file_get_contents(storage_path('app/wizard-data.json')), true);
$page = collect($pages)->firstWhere('slug', $slug);
abort_unless($page, 404);
return response($page['body_html'])
->header('Content-Type', 'text/html; charset=utf-8');
});保持“延伸阅读”链接和 /blog 网址正常工作
- 页面之间的链接使用您在第 3 步选择的网址结构:/blog/{slug},设置语言前缀时为 /{prefix}/blog/{slug}。在第 1 步填写的网站上按这个路径提供每个页面,链接和页面的结构化数据就无需任何修改即可正确。
- 如果页面放在其他路径下,请不要手动修改 HTML。每个“延伸阅读”链接都带有 data-pseo-link 属性,值为目标页面的 slug,可以一次性全部改写:
read-also.js // Each "Read also" link carries data-pseo-link="<slug>" const html = page.body_html.replace( /href="[^"]*"(\s+data-pseo-link="([^"]+)")/g, (_, attr, slug) => `href="/guides/${slug}"${attr}` ); - 而 dist/ 中的 HTML 文件之间以 {slug}.html 互相链接。把它们一起上传到同一个文件夹(最好是 /blog),无论是否开启简洁网址都能正常工作。
- 请一次性导入同一活动的全部页面。指向未导入页面的链接会变成 404:HTML 导出会自动删除这类链接;在您自己的应用中,也可以跳过 slug 不在数据中的链接。
- 页面上线后不要再修改 slug。如果必须修改,请从旧地址到新地址添加 301 重定向。
/publish
无需代码发布
在第 5 步连接您的网站,我们会替您发送页面。您只需从平台获取一次密钥,下面的步骤告诉您在哪里找到它。
WordPress
页面以文章草稿的形式导入,您可以在上线前检查。
- 在 WordPress 后台打开 用户 → 个人资料,向下滚动到“应用程序密码”。
- 输入一个名称,例如“pSEO Wizard”,点击“添加新应用程序密码”,并复制显示的密码。它只会显示一次。
- 在第 5 步选择 WordPress,填写网站地址、WordPress 用户名和这个应用程序密码(不是平时的登录密码)。
- 点击“发布”,然后在 WordPress 中打开 文章 → 草稿,检查页面后再发布。
Shopify
页面会作为已发布的文章添加到您选择的博客中。
- 在 Shopify 后台打开 设置 → 应用和销售渠道 → 开发应用,然后创建一个应用。
- 在“配置 Admin API 权限范围”中开启 read_content 和 write_content,保存后点击“安装应用”。
- 打开“API 凭据”,复制以 shpat_ 开头的 Admin API 访问令牌。
- 在第 5 步选择 Shopify,填写店铺地址(yourstore.myshopify.com)和令牌,选择一个博客,然后点击“发布”。
Webflow
页面会作为 CMS 集合中的条目添加,下次发布网站时上线。
- 在 Webflow Designer 中创建一个 CMS 集合(例如“指南”),包含富文本字段 Post Body 和文本字段 Post Summary。Webflow 的博客模板已经自带这两个字段。
- 打开该集合的模板页,把名称和 Post Body 绑定到页面布局。
- 在 网站设置 → 应用与集成 → API 访问 中创建 API 令牌。
- 在第 5 步选择 Webflow,粘贴令牌,选择网站和集合,点击“发布”,然后在 Webflow 中发布网站。
WooCommerce
页面会作为产品草稿添加,适合介绍您所售商品的页面。
- 在 WordPress 后台打开 WooCommerce → 设置 → 高级 → REST API,点击“添加密钥”。
- 为密钥设置读/写权限,然后复制 Consumer key(ck_…)和 Consumer secret(cs_…)。
- 在第 5 步选择 WooCommerce,填写店铺地址和两个密钥,点击“发布”,然后在“产品”中检查草稿。
Wix
目前还不能直接连接 Wix,但您可以手动添加页面。
- 在第 5 步下载页面(见上方“下载页面”)。
- 在 Wix 编辑器中新建一个页面,添加 嵌入代码 → 嵌入 HTML,然后粘贴某个页面 .html 文件的全部内容。
- 在 Wix 中设置与之对应的页面网址和 SEO 标题。搜索引擎读取嵌入的 HTML 不如普通页面可靠,所以 WordPress、Shopify 或 Webflow 通常排名更好。
/pricing
价格与支付
每个页面只需付费一次。没有订阅,每个账户的第一页免费。
| 页数 | 每页价格 |
|---|---|
| 1–500 | US$0.30 |
| 501–1,500 | US$0.25 |
| 1,501–3,500 | US$0.20 |
| 3,501+ | US$0.15 |
- 价格按区间累进:每个价格只适用于该区间内的页面。例如,600 页的费用是 500 × $0.30 + 100 × $0.25 = $175。
- 付费订单至少 10 页。没有折扣,也没有优惠码。
- 如果您修改已付款的活动,尚未生成的页面费用会作为余额退回您的账户,可用于下一个订单。
- 支付由我们的 Merchant of Record Dodo Payments 处理,支持银行卡和本地支付方式,并在结账时加上适用的销售税或增值税。
/facts
页面如何保持准确
搜索引擎和客户都会惩罚编造内容的页面。以下规则适用于每个页面:
信息来自您的网站
价格、服务、评价和数字只取自您的网站和您填写的关键信息。网站上没有的数字会从页面中删除。
每个页面都不同
每个页面都有自己的写作计划,完成的页面会相互比较。与其他页面重复过多的页面会被重写。
如实对待地点
如果客户需要到店,我们会提醒您哪些地点太远。如果您上门服务,页面会说您服务该区域,绝不会说您在那里有分店。
发布在 /blog 下
页面默认放在 /blog 文件夹中,让大量新页面与网站其他部分分开。
/help
常见问题排查
- WordPress 提示登录信息错误(401 或 403)
- 请使用应用程序密码而不是平时的密码,并填写 WordPress 用户名(不是邮箱)。有些安全插件会屏蔽 WordPress REST API,请为您的用户放行后重试。
- Shopify 无法连接
- 请使用以 shpat_ 开头的 Admin API 访问令牌,并为应用开启 read_content 和 write_content 权限。修改权限后,重新安装应用并复制新的令牌。
- 上传后页面显示 404
- 检查文件是否放在页面网址所对应的文件夹中(例如 /blog/),以及第 3 步设置的网址语言前缀是否与您的网站一致。
- 按钮链接到错误的页面
- 按钮会指向第 1 步中的目标网址;如果您的网站上有对应页面(预约、菜单、价格、联系),则指向该页面。请在生成前设置好目标网址;对已生成的页面,可在第 4 步的页面编辑器中修改链接。
仍有问题?发送邮件至 support@wizardseo.co,我们会帮您解决。