# SEOArchitect Workbook · کتاب کار

A hands-on, bilingual guide. Pick the language that's easier for you and
follow each chapter in order. Every chapter has three parts: **Why this
matters**, **What to do** (numbered steps), and **What you should see**.

یک راهنمای دستی و دوزبانه. زبانی که برات راحت‌تره رو انتخاب کن و فصل‌ها
رو به ترتیب جلو برو. هر فصل سه بخش داره: **چرا مهمه**، **چه کار کن**
(قدم‌به‌قدم) و **چی باید ببینی**.

---

## Table of contents · فهرست

1. [What SEOArchitect is · SEOArchitect چیست](#1-what-seoarchitect-is--seoarchitect-چیست)
2. [Sign up and first login · ثبت‌نام و ورود اول](#2-sign-up-and-first-login--ثبتنام-و-ورود-اول)
3. [Tour of the dashboard · گشتی در داشبورد](#3-tour-of-the-dashboard--گشتی-در-داشبورد)
4. [Add your first site · افزودن اولین سایت](#4-add-your-first-site--افزودن-اولین-سایت)
5. [Connect Google for live data · اتصال گوگل برای داده‌ی واقعی](#5-connect-google-for-live-data--اتصال-گوگل-برای-دادهی-واقعی)
6. [Run your first audit · اجرای اولین ممیزی](#6-run-your-first-audit--اجرای-اولین-ممیزی)
7. [Discover keywords · پیدا کردن کلمات کلیدی](#7-discover-keywords--پیدا-کردن-کلمات-کلیدی)
8. [Generate a content brief · تولید بریف محتوا](#8-generate-a-content-brief--تولید-بریف-محتوا)
9. [Generate a full draft · تولید پیش‌نویس کامل](#9-generate-a-full-draft--تولید-پیشنویس-کامل)
10. [The SEO Pro suite · مجموعه‌ی SEO Pro](#10-the-seo-pro-suite--مجموعهی-seo-pro)
11. [Read the next-actions banner · خواندن نوار اقدام بعدی](#11-read-the-next-actions-banner--خواندن-نوار-اقدام-بعدی)
12. [Billing and plans · صورتحساب و پلن‌ها](#12-billing-and-plans--صورتحساب-و-پلنها)
13. [Troubleshooting · رفع اشکال](#13-troubleshooting--رفع-اشکال)
14. [Glossary · واژه‌نامه](#14-glossary--واژهنامه)

---

## 1. What SEOArchitect is · SEOArchitect چیست

### EN

SEOArchitect is a SaaS where twelve AI agents do SEO work for you. Each
agent is a specialist: one finds keywords, one writes briefs, one
audits your site, one fixes schema, and so on. They read your **real**
Search Console + Analytics data once you connect Google, and they ask
you to approve anything risky before publishing it.

You stay the editor-in-chief. The agents do the leg work.

### FA

SEOArchitect یک نرم‌افزار SaaS است که در آن دوازده ایجنت هوش مصنوعی
کارهای سئو را برایت انجام می‌دهند. هر ایجنت یک متخصص جداگانه است: یکی
کلمات کلیدی پیدا می‌کند، یکی بریف می‌نویسد، یکی سایتت را ممیزی می‌کند،
یکی schema را اصلاح می‌کند و همین‌طور بقیه. وقتی حساب گوگلت را متصل
کردی، روی **داده‌ی واقعی** Search Console و Analytics کار می‌کنند و
قبل از انتشار هر چیز ریسکی، از تو تأیید می‌گیرند.

تو سردبیر هستی. ایجنت‌ها کار سنگین را انجام می‌دهند.

---

## 2. Sign up and first login · ثبت‌نام و ورود اول

### EN — Why this matters

Every action in SEOArchitect happens inside a **workspace** (your org).
You and your team share that workspace; data is isolated from other
customers.

### EN — What to do

1. Open <https://seoarchitect.app/signup>.
2. You have two options:
   - **Email + password**: fill in full name, workspace name (e.g.
     `Acme SEO`), email, and a password (≥8 characters).
   - **Continue with Google**: one click; an org is auto-created.
3. Read the *Terms* and *Privacy* links once. Check `/refunds` if
   you want to know our refund window.

### EN — What you should see

You land on the **Dashboard** with a "Welcome" card listing three
foundational steps to take. Don't skip these — chapters 4–6 walk
you through them.

### FA — چرا مهمه

تمام فعالیت‌ها در SEOArchitect داخل یک **فضای کاری (workspace)** انجام
می‌شود. تو و اعضای تیمت در آن فضا مشترکید و داده‌ی شما از مشتری‌های
دیگر کاملاً ایزوله است.

### FA — چه کار کن

1. به آدرس <https://seoarchitect.app/signup> برو (یا برای نسخه فارسی:
   <https://seoarchitect.ca/signup>).
2. دو راه داری:
   - **ایمیل و رمز عبور**: نام کامل، نام فضای کاری (مثلاً `سئو آکمی`)،
     ایمیل و رمز عبور (حداقل ۸ کاراکتر) را وارد کن.
   - **ورود با گوگل**: یک کلیک؛ workspace خودکار ساخته می‌شود.
3. لینک‌های *Terms* و *Privacy* را یک بار بخوان. اگر می‌خواهی پنجره‌ی
   استرداد را بدانی، `/refunds` را هم نگاه کن.

### FA — چی باید ببینی

به **داشبورد** می‌روی و یک کارت «Welcome» سه گام پایه را به تو نشان
می‌دهد. این سه را رد نکن — فصل‌های ۴ تا ۶ همان‌ها هستند.

---

## 3. Tour of the dashboard · گشتی در داشبورد

### EN

Three regions matter:

- **Sidebar (left/right)** — Dashboard, Sites, Inbox, Billing, Settings.
- **Topbar** — your account menu, copilot trigger.
- **Main area** — the page content.

Three floating buttons:

- **🤖 Copilot** (bottom corner) — ask a free-form question.
- **↑ Scroll to top** (above Copilot) — quick navigation on long pages.
- **Onboarding tour** (only first time) — a small spotlight tutorial.

### FA

سه ناحیه مهم است:

- **Sidebar** — داشبورد، سایت‌ها، Inbox، صورتحساب، تنظیمات.
- **Topbar** — منوی حساب، دکمه‌ی Copilot.
- **بدنه‌ی صفحه** — محتوای هر مسیر.

سه دکمه‌ی شناور:

- **🤖 Copilot** (گوشه‌ی پایین) — سؤال آزاد بپرس.
- **↑ بازگشت به بالا** (بالای Copilot) — برای صفحات طولانی.
- **تور آنبوردینگ** (فقط بار اول) — راهنمای spotlight کوچک.

---

## 4. Add your first site · افزودن اولین سایت

### EN — Why this matters

Every agent needs a target. A "site" is a domain you want to grow.

### EN — What to do

1. Sidebar → **Sites** → **+ Add site**.
2. Enter the domain (e.g. `example.com`, no `https://`).
3. Optionally fill the **profile**: industry, country, target audience,
   brand voice, primary services. Spend 2 minutes here — agents work
   5–10× better with profile context.

### EN — What you should see

The new site shows in the sites list with a **GSC** and **GA4** badge,
both initially `—` (not connected).

### FA — چرا مهمه

هر ایجنت نیاز به یک هدف دارد. «سایت» یعنی دامنه‌ای که می‌خواهی رشدش
بدهی.

### FA — چه کار کن

1. Sidebar → **Sites** → **+ Add site**.
2. دامنه را بنویس (مثلاً `example.com` بدون `https://`).
3. در صورت تمایل **پروفایل** را پر کن: صنعت، کشور، مخاطب هدف،
   لحن برند، خدمات اصلی. ۲ دقیقه برایش وقت بگذار — ایجنت‌ها با
   پروفایل ۵ تا ۱۰ برابر بهتر کار می‌کنند.

### FA — چی باید ببینی

سایت جدید در لیست با دو نشان **GSC** و **GA4** ظاهر می‌شود که هر دو
اول `—` هستند (متصل نیست).

---

## 5. Connect Google for live data · اتصال گوگل برای داده‌ی واقعی

### EN — Why this matters

Without Google, agents work from estimates. With Google, every report
uses your real impressions, clicks, queries, and sessions.

### EN — What to do

1. Sidebar → **Settings → Integrations**.
2. Click **Connect Google**. Pick the Google account that owns your
   Search Console / GA4 properties.
3. Approve the requested scopes:
   - `webmasters.readonly` (read GSC data)
   - `analytics.readonly` (read GA4 data)
4. You'll come back to **Integrations** with a green "Connected as
   <email>" banner.
5. For each site, pick the correct GSC site URL and GA4 property in
   the **Site bindings** dropdowns.

### EN — What you should see

The site detail page now shows two new cards: **Search Console** (last
28 days) and **Analytics 4** (last 28 days), with KPI tiles and bar
sparklines.

### EN — Privacy promise

We only **read** your scoped data. We never send email through your
Google account, never modify your settings, never train AI models on
your content. You can disconnect any time and we revoke the token at
Google.

### FA — چرا مهمه

بدون گوگل، ایجنت‌ها بر اساس برآورد کار می‌کنند. با گوگل، هر گزارش از
ایمپرشن، کلیک، کوئری و سشن واقعی تو استفاده می‌کند.

### FA — چه کار کن

1. Sidebar → **Settings → Integrations**.
2. روی **Connect Google** کلیک کن. حساب گوگلی که Search Console و GA4
   تو در آن است را انتخاب کن.
3. این دسترسی‌ها را تأیید کن:
   - `webmasters.readonly` (خواندن داده‌ی Search Console)
   - `analytics.readonly` (خواندن داده‌ی GA4)
4. به **Integrations** بازمی‌گردی و یک نوار سبز "Connected as
   <ایمیل>" می‌بینی.
5. برای هر سایت، در قسمت **Site bindings** آدرس GSC و property GA4
   درست را از dropdown انتخاب کن.

### FA — چی باید ببینی

در صفحه‌ی سایت دو کارت جدید ظاهر می‌شود: **Search Console** و
**Analytics 4** (هر دو ۲۸ روز اخیر) با KPIها و نمودارهای میله‌ای.

### FA — تعهد حریم خصوصی

ما فقط داده‌های scope-شده را **می‌خوانیم**. هرگز با حساب گوگلت ایمیل
نمی‌فرستیم، تنظیماتت را تغییر نمی‌دهیم و محتوای تو را برای آموزش
مدل‌های AI استفاده نمی‌کنیم. هر زمان قطع کنی، توکن در گوگل هم لغو
می‌شود.

---

## 6. Run your first audit · اجرای اولین ممیزی

### EN — Why this matters

The audit catches 15+ technical, on-page, and structured-data issues
in ~3 seconds. It's the fastest "do I have anything obviously broken?"
check.

### EN — What to do

1. Open your site detail page.
2. Click **Run audit** (or accept the next-actions banner suggestion).
3. Wait ~3 seconds.
4. Read the score (0–100) + the issue counts: critical / warning /
   info.
5. Click any critical issue to see the exact element on the page and
   the suggested fix.

### EN — What you should see

A score, a colored bar of issue severity, and an expandable list. If
your score < 70 with critical issues, the next-actions banner adds a
"Fix N critical issues on <domain>" suggestion.

### FA — چرا مهمه

این ممیزی بیش از ۱۵ ایراد فنی، on-page و structured-data را در ~۳
ثانیه پیدا می‌کند. سریع‌ترین چک «آیا چیز واضحاً خراب دارم؟» است.

### FA — چه کار کن

1. صفحه‌ی سایتت را باز کن.
2. روی **Run audit** کلیک کن (یا پیشنهاد next-actions را بپذیر).
3. حدود ۳ ثانیه صبر کن.
4. امتیاز (۰–۱۰۰) و تعداد ایرادها (بحرانی / هشدار / اطلاع) را بخوان.
5. روی هر ایراد بحرانی کلیک کن تا عنصر دقیق صفحه و راه پیشنهادی
   اصلاح را ببینی.

### FA — چی باید ببینی

یک امتیاز، یک نوار رنگی شدت ایرادها، و لیست قابل گسترش. اگر امتیاز
کمتر از ۷۰ با ایرادهای بحرانی بود، در next-actions پیشنهاد "Fix N
critical issues on <domain>" اضافه می‌شود.

---

## 7. Discover keywords · پیدا کردن کلمات کلیدی

### EN — Why this matters

Most SEO failures start at keyword choice. The Keyword Discovery agent
combines DataForSEO volume, SERP density, Google Trends, and Claude
synthesis into an opportunity score per keyword.

### EN — What to do

1. Site detail → **Keywords** tab.
2. Click **AI Discover** and enter a topic seed (e.g. "vegan protein
   powder" or whatever you actually sell).
3. Wait ~30 seconds.
4. Review the table: keyword, volume, difficulty, CTR potential,
   opportunity score (0–100). Sort by opportunity.

### EN — What you should see

25 keywords with opportunity ≥ 50 ranked first. The agent flags any
keyword you already rank top-3 for as "defend" instead of "attack".

### FA — چرا مهمه

اکثر شکست‌های سئو از انتخاب کلمه‌ی کلیدی بد شروع می‌شود. ایجنت
Keyword Discovery داده‌ی DataForSEO، تراکم SERP، روند گوگل و synthesis
کلود را روی هم ترکیب می‌کند و برای هر کلمه یک opportunity score
محاسبه می‌کند.

### FA — چه کار کن

1. صفحه‌ی سایت → تب **Keywords**.
2. روی **AI Discover** کلیک کن و یک seed topic بنویس (مثلاً «پودر
   پروتئین گیاهی» یا هر چیزی که واقعاً می‌فروشی).
3. حدود ۳۰ ثانیه صبر کن.
4. جدول را ببین: کلمه، حجم جستجو، سختی، پتانسیل CTR، امتیاز
   فرصت (۰–۱۰۰). بر اساس opportunity مرتب کن.

### FA — چی باید ببینی

۲۵ کلمه با opportunity ≥ ۵۰ در صدر. اگر در ۳ نتیجه‌ی اول قبلاً
جایگاه داری، ایجنت آن را به جای «attack» با برچسب «defend» نشان
می‌دهد.

---

## 8. Generate a content brief · تولید بریف محتوا

### EN — Why this matters

A good brief is the difference between an article that ranks and a
$200 wasted writer fee.

### EN — What to do

1. Site detail → **Content** tab → **+ New brief**.
2. Pick a keyword from the discovery results (Chapter 7).
3. Optionally add target word count and intent (informational /
   commercial / transactional).
4. Click **Generate brief**. ~20 seconds.

### EN — What you should see

A structured brief: H1 + intro angle, ≥6 H2 sections each with
talking points, internal-link suggestions, FAQ block, schema
recommendation, and a "what NOT to write" list of off-topic angles
your competitors keep including.

### FA — چرا مهمه

یک بریف خوب فاصله‌ی بین مقاله‌ای که رتبه می‌گیرد و ۲۰۰ دلار هدر رفته
نویسنده است.

### FA — چه کار کن

1. صفحه‌ی سایت → تب **Content** → **+ New brief**.
2. یک کلمه کلیدی از نتایج کشف کلمات (فصل ۷) انتخاب کن.
3. در صورت تمایل، تعداد کلمات هدف و intent را تنظیم کن
   (informational / commercial / transactional).
4. **Generate brief** را بزن. حدود ۲۰ ثانیه.

### FA — چی باید ببینی

یک بریف ساختاریافته: H1 با زاویه‌ی مقدمه، حداقل ۶ بخش H2 با نکات
صحبت، پیشنهاد لینک داخلی، بخش FAQ، توصیه‌ی schema و لیست «چه چیزی
ننویس» از زاویه‌های پرت که رقبا هنوز شامل می‌کنند.

---

## 9. Generate a full draft · تولید پیش‌نویس کامل

### EN — Why this matters

Once you approve the brief, an agent can write the actual article.
Treat it as a v1 — review and edit before publishing.

### EN — What to do

1. Open the brief.
2. Click **Generate draft**. ~60 seconds for a ~1500-word article.
3. Read it. Edit anywhere it's vague or generic. Add your real
   examples, customer quotes, internal links.
4. Optionally hit **Generate hero image** for a cover image.
5. **Save draft** or **Push to WordPress** if your CMS is connected.

### EN — What you should see

A markdown article with H1/H2/H3 structure that matches the brief,
internal links inserted to your existing pages, and a recommended
slug + meta description.

### FA — چرا مهمه

وقتی بریف را تأیید کردی، ایجنت می‌تواند خود مقاله را بنویسد. آن را
به‌عنوان نسخه ۱ ببین — قبل از انتشار بازبینی و ویرایش کن.

### FA — چه کار کن

1. بریف را باز کن.
2. **Generate draft** را بزن. حدود ۶۰ ثانیه برای مقاله‌ی ۱۵۰۰
   کلمه‌ای.
3. بخوان. هر جا کلی یا گُنگ بود ویرایش کن. مثال‌های واقعی، نقل قول
   مشتریان و لینک داخلی اضافه کن.
4. در صورت تمایل **Generate hero image** را برای تصویر کاور بزن.
5. **Save draft** یا اگر CMS وصل است **Push to WordPress**.

### FA — چی باید ببینی

یک مقاله‌ی markdown با ساختار H1/H2/H3 منطبق بر بریف، لینک‌های
داخلی به صفحات موجودت، و یک slug و meta description پیشنهادی.

---

## 10. The SEO Pro suite · مجموعه‌ی SEO Pro

### EN

The site detail page has a **SEO Pro** panel with eight specialized
modules. Run them when relevant:

- **Backlinks** — discover and audit incoming links.
- **Rank tracker** — daily position for tracked keywords.
- **Crawl** — spider your site to find broken links and orphan pages.
- **Cannibal** — detect content cannibalization (two pages competing
  for the same keyword).
- **Decay** — flag pages losing impressions over time.
- **Mentions** — find unlinked brand mentions.
- **Multi-engine** — measure visibility across Google + Bing + DDG.
- **Topical** — map topical authority gaps.

Each runs on demand or on a schedule (Pro+ plans).

### FA

صفحه‌ی سایت یک پنل **SEO Pro** با هشت ماژول تخصصی دارد. هر کدام را
وقتی لازم بود اجرا کن:

- **Backlinks** — کشف و ممیزی لینک‌های ورودی.
- **Rank tracker** — رتبه‌ی روزانه برای کلمات tracked.
- **Crawl** — خزش سایتت برای پیدا کردن لینک‌های خراب و صفحات یتیم.
- **Cannibal** — پیدا کردن content cannibalization (دو صفحه روی یک
  کلمه رقابت کنند).
- **Decay** — صفحاتی که در طول زمان impression از دست می‌دهند.
- **Mentions** — پیدا کردن نام برند بدون لینک.
- **Multi-engine** — visibility در Google + Bing + DuckDuckGo.
- **Topical** — نقشه‌ی شکاف اعتبار موضوعی.

هر کدام on-demand یا با schedule (پلن Pro به بالا).

---

## 11. Read the next-actions banner · خواندن نوار اقدام بعدی

### EN

The dashboard's **Next-Action Banner** answers "what's the highest-
leverage thing to do today?" It's deterministic — the same state
always returns the same suggestion. Priority order:

1. Add first site (priority 100)
2. Profile completion (95)
3. Connect Google (92)
4. Bind a Google property to a site (88)
5. Run first audit (90)
6. Fix critical issues (85)
7. Discover keywords (70)
8. First brief (60)
9. First draft (55)
10. AI visibility check (40)

If you're stuck, just take the top suggestion. It's the one with the
biggest impact for the smallest effort.

### FA

**Next-Action Banner** داشبورد به این سؤال جواب می‌دهد: «امروز چه
کاری بیشترین اثر را دارد؟» قطعی است — یک وضعیت همیشه یک پیشنهاد می‌دهد.
ترتیب اولویت:

1. افزودن اولین سایت (اولویت ۱۰۰)
2. تکمیل پروفایل (۹۵)
3. اتصال گوگل (۹۲)
4. bind کردن property گوگل به سایت (۸۸)
5. اجرای اولین ممیزی (۹۰)
6. اصلاح ایرادهای بحرانی (۸۵)
7. کشف کلمات کلیدی (۷۰)
8. اولین بریف (۶۰)
9. اولین پیش‌نویس (۵۵)
10. چک visibility در AI (۴۰)

اگر گیر کردی، اولین پیشنهاد را انجام بده. بیشترین اثر را در کمترین
زحمت دارد.

---

## 12. Billing and plans · صورتحساب و پلن‌ها

### EN

Five plans:

| Plan | $/month | sites | keywords | agent calls/mo |
|---|---|---|---|---|
| Free | 0 | 1 | 25 | 100 |
| Solo | 49 | 1 | 100 | 500 |
| Pro | 149 | 5 | 500 | 2,000 |
| Agency | 499 | 25 | 2,500 | 10,000 |
| Scale | 1,499 | 100 | 10,000 | 50,000 |

To upgrade:

1. Sidebar → **Billing**.
2. Pick a plan → **Upgrade**.
3. You're sent to Stripe Checkout. Complete payment with any major
   card. Apple Pay / Google Pay supported.
4. You return to the billing page with the new plan active.

To cancel:

1. **Billing → Manage subscription** → **Cancel**.
2. Your access continues until the end of the current period.
3. We never charge again unless you re-subscribe.

Refund window: 14 days, full refund. See `/refunds` for the policy.

### FA

پنج پلن:

| پلن | دلار/ماه | سایت | کلمات کلیدی | فراخوانی ایجنت/ماه |
|---|---|---|---|---|
| رایگان | ۰ | ۱ | ۲۵ | ۱۰۰ |
| Solo | ۴۹ | ۱ | ۱۰۰ | ۵۰۰ |
| Pro | ۱۴۹ | ۵ | ۵۰۰ | ۲٬۰۰۰ |
| Agency | ۴۹۹ | ۲۵ | ۲٬۵۰۰ | ۱۰٬۰۰۰ |
| Scale | ۱٬۴۹۹ | ۱۰۰ | ۱۰٬۰۰۰ | ۵۰٬۰۰۰ |

برای ارتقا:

1. Sidebar → **Billing**.
2. یک پلن انتخاب کن → **Upgrade**.
3. به Stripe Checkout می‌روی. با هر کارت اعتباری بزرگی پرداخت کن.
   Apple Pay و Google Pay هم پشتیبانی می‌شود.
4. به صفحه‌ی billing برمی‌گردی و پلن جدید فعال است.

برای لغو:

1. **Billing → Manage subscription** → **Cancel**.
2. دسترسی‌ات تا پایان دوره‌ی فعلی ادامه دارد.
3. مگر اینکه دوباره اشتراک بگیری، دیگر از تو پولی نمی‌گیریم.

پنجره‌ی استرداد: ۱۴ روز، استرداد کامل. سیاست در `/refunds`.

---

## 13. Troubleshooting · رفع اشکال

### EN

**"Connect Google" is stuck on a 500 error.**
We auto-capture this in Sentry. Email <support@seoarchitect.app> with
your workspace name; usually fixed in <1 hour.

**"Run audit" returns nothing for 30+ seconds.**
Refresh the page. The audit endpoint has a 60-second budget; if your
site is slow to crawl, it may time out. Try a single URL audit instead.

**"Generate draft" output is generic.**
Almost always because the site profile is empty. Open the site, fill
in industry / audience / brand voice, regenerate.

**Two Google accounts connected, but properties only show one.**
Known limitation right now: only the most-recent credential is
queried. Disconnect the one without GSC/GA4 access.

**Forgot password.**
`/forgot-password` → enter your email. You receive a reset link via
Resend within 1 minute.

**Welcome email never arrived.**
Check spam. If still missing, the sender domain might be flagged on
your provider — email <support@seoarchitect.app> and we'll resend.

### FA

**«Connect Google» در خطای ۵۰۰ گیر کرده.**
ما خودکار این را در Sentry ضبط می‌کنیم. به <support@seoarchitect.app>
ایمیل بزن با نام workspace؛ معمولاً کمتر از ۱ ساعت رفع می‌شود.

**«Run audit» بیش از ۳۰ ثانیه چیزی برنمی‌گرداند.**
صفحه را refresh کن. endpoint ممیزی ۶۰ ثانیه بودجه دارد؛ اگر سایتت
کند خزیده شود، timeout می‌خورد. به جایش ممیزی تک‌URL را امتحان کن.

**خروجی «Generate draft» کلی است.**
تقریباً همیشه به خاطر خالی بودن پروفایل سایت است. سایت را باز کن،
صنعت / مخاطب / لحن برند را پر کن، دوباره generate کن.

**دو حساب گوگل وصل شده ولی فقط properties یکی نشان داده می‌شود.**
محدودیت فعلی شناخته‌شده: فقط آخرین credential کوئری می‌شود. حسابی
که GSC/GA4 ندارد را disconnect کن.

**رمز عبور را فراموش کرده‌ام.**
`/forgot-password` → ایمیلت را وارد کن. لینک reset از طریق Resend
ظرف ۱ دقیقه می‌رسد.

**ایمیل خوش‌آمد نرسید.**
spam را چک کن. اگر باز نبود، دامین فرستنده ممکن است نزد provider
تو علامت داشته باشد — به <support@seoarchitect.app> ایمیل بزن، دوباره
می‌فرستیم.

---

## 14. Glossary · واژه‌نامه

### EN

| Term | Meaning |
|---|---|
| **Workspace / Org** | The container for a customer account. Multi-tenant isolated. |
| **Site** | A domain inside a workspace, with its own profile + bindings. |
| **Agent** | A specialized AI assistant (12 of them: Strategist, Keyword, Content, Audit, Crawl, Backlinks, Decay, Cannibal, Mentions, Schema, Reporter, AI Visibility). |
| **Task** | One unit of agent work. Lifecycle: `pending → running → completed` (or `failed`). |
| **GSC** | Google Search Console — your impressions, clicks, queries. |
| **GA4** | Google Analytics 4 — your sessions, users, page views. |
| **Brief** | A structured outline an agent creates so a writer can produce the article. |
| **Schema** | Structured-data markup (JSON-LD) that helps search engines understand the page. |
| **HITL** | Human-in-the-loop. Any task with risk score ≥ 0.7 needs your approval before publishing. |
| **AI Visibility** | Whether your brand surfaces in answers from ChatGPT, Claude, Perplexity, Gemini. The new SEO frontier. |

### FA

| اصطلاح | معنا |
|---|---|
| **Workspace / Org (فضای کاری)** | ظرف یک حساب مشتری. چندمستاجره و ایزوله. |
| **Site** | یک دامنه داخل workspace با پروفایل و binding مخصوص خودش. |
| **Agent (ایجنت)** | یک دستیار AI تخصصی (۱۲ تا: Strategist، Keyword، Content، Audit، Crawl، Backlinks، Decay، Cannibal، Mentions، Schema، Reporter، AI Visibility). |
| **Task (وظیفه)** | یک واحد کار ایجنت. چرخه‌ی عمر: `pending → running → completed` (یا `failed`). |
| **GSC** | Google Search Console — ایمپرشن، کلیک، کوئری. |
| **GA4** | Google Analytics 4 — سشن، کاربر، page view. |
| **Brief (بریف)** | طرحی ساختاریافته که ایجنت می‌سازد تا نویسنده مقاله را تولید کند. |
| **Schema** | داده‌ی ساختاریافته (JSON-LD) که موتورهای جستجو محتوای صفحه را بهتر می‌فهمند. |
| **HITL** | انسان در حلقه. هر تسک با ریسک ≥ ۰٫۷ قبل از انتشار نیاز به تأیید تو دارد. |
| **AI Visibility** | اینکه برندت در پاسخ‌های ChatGPT، Claude، Perplexity، Gemini نمایان می‌شود یا نه. مرز جدید سئو. |

---

## Appendix · ضمیمه

### EN — One-page quickstart

```
Day 1 (10 minutes)
  1. Sign up
  2. Add your first site + fill profile
  3. Connect Google
  4. Bind GSC + GA4 properties to the site
  5. Run first audit

Day 2 (10 minutes)
  6. Discover 25 keywords
  7. Pick the top 3 by opportunity
  8. Generate a brief for keyword #1

Day 3 (15 minutes)
  9. Generate the draft
  10. Edit and publish

Day 4+
  11. Set up Rank Tracker for 5 keywords
  12. Schedule weekly audits
  13. Open the Reporter agent every Monday for a digest
```

### FA — راه‌اندازی یک‌صفحه‌ای

```
روز ۱ (۱۰ دقیقه)
  1. ثبت‌نام
  2. اولین سایت + پر کردن پروفایل
  3. اتصال گوگل
  4. bind کردن GSC + GA4 به سایت
  5. اجرای اولین ممیزی

روز ۲ (۱۰ دقیقه)
  6. کشف ۲۵ کلمه‌ی کلیدی
  7. ۳ تا برتر بر اساس opportunity
  8. تولید بریف برای کلمه‌ی #۱

روز ۳ (۱۵ دقیقه)
  9. تولید پیش‌نویس
  10. ویرایش و انتشار

روز ۴ به بعد
  11. Rank Tracker برای ۵ کلمه‌ی کلیدی
  12. ممیزی هفتگی schedule
  13. هر دوشنبه ایجنت Reporter را باز کن برای خلاصه
```

---

**Need help · نیاز به کمک:**
<support@seoarchitect.app>
