@cloudcreate/adsense-check 1.0.0 → 1.0.1

package/README.md

@@ -1,76 +1,150 @@
-# adsense-check
+# @cloudcreate/adsense-check
 
-Check if a website meets Google AdSense review requirements.
+Automated website checker for Google AdSense review requirements. Focuses on detecting "low value content" — the #1 rejection reason.
 
 ## Install
 
 ```bash
-npm install -g adsense-check
+npm install -g @cloudcreate/adsense-check
 ```
 
-## Usage
+Or run directly without installing:
 
 ```bash
-# Basic check
-adsense-check https://example.com
+npx @cloudcreate/adsense-check https://example.com
+```
 
-# JSON output (for programmatic use)
-adsense-check https://example.com --json
+## Quick Start
 
-# Crawl more internal pages (default: 5)
-adsense-check https://example.com --depth 10
+```bash
+# Full check with AI analysis
+adsense-check https://example.com
 
-# Skip AI content analysis
+# Quick check without AI
 adsense-check https://example.com --skip-ai
 
-# Custom timeout (ms)
-adsense-check https://example.com --timeout 60000
+# JSON output (for programmatic use)
+adsense-check https://example.com --json
 ```
 
-## What it checks
-
-| Category | Checks |
-|----------|--------|
-| **Content Quality** | Page word count, content duplication |
-| **Required Pages** | About, Privacy Policy, Contact, Terms of Service |
-| **Site Structure** | H1 tags, robots.txt, sitemap.xml, internal links, dead links |
-| **Performance** | Load time, mobile viewport, responsive layout, font size, popups |
-| **Policy Compliance** | Blacklisted keywords (porn, gambling, piracy, etc.) |
-| **AI Analysis** | Content originality, quality, compliance (requires `AI_API_KEY`) |
+Reports are auto-saved to `tmp/<domain>-<timestamp>.json`.
+
+## What It Checks
+
+| Category | Checks | Focus |
+|----------|--------|-------|
+| **Content Quality** (8) | Content ratio, depth, template detection, filler detection, duplication, freshness, site scale | Low-value content |
+| **Required Pages** (4) | About, Privacy Policy, Contact, Terms of Service | Completeness |
+| **Site Structure** (5) | H1 tags, robots.txt, sitemap, internal links, dead links | Crawlability |
+| **Performance** (5) | Load speed, viewport, mobile overflow, font size, popups | User experience |
+| **Policy Compliance** (1) | Blacklisted keywords | AdSense policy |
+| **AI Analysis** (3+) | Content value, originality, compliance + per-page analysis | Low-value content |
+
+### Content Quality (Anti Low-Value Content)
+
+The core focus of this tool — detecting content that AdSense reviewers flag as "low value":
+
+- **Content Ratio**: Strips navigation/footer/sidebar, measures real content percentage
+- **Content Depth**: Per-page word count of actual content (not total page text)
+- **Template Detection**: Flags pages with identical structures but different words
+- **Filler Detection**: Catches repeated phrases, padding, meaningless text
+- **Cross-Page Duplication**: Segment-level dedup across all crawled pages
+- **Content Freshness**: Checks if site has been updated recently
+- **Site Scale**: Warns if site has too few content pages
+
+### AI Per-Page Analysis
+
+With AI enabled, each crawled page gets individual assessment:
+
+```json
+{
+  "pages": [
+    {
+      "url": "https://example.com/blog/post-1",
+      "title": "Post Title",
+      "contentChars": 1200,
+      "contentRatio": 85,
+      "contentStatus": "pass",
+      "issues": [],
+      "ai": {
+        "status": "pass",
+        "assessment": "Content provides genuine value...",
+        "suggestions": ["Add more specific examples"]
+      }
+    }
+  ]
+}
+```
 
 ## Options
 
 ```
--v, --version        Show version
--j, --json           Output as JSON
--d, --depth <n>      Number of internal pages to crawl (default: 5)
--s, --skip-ai        Skip AI content analysis
--t, --timeout <ms>   Page load timeout (default: 30000)
---api-key <key>      Anthropic API key (or set ANTHROPIC_API_KEY env var)
+-v, --version         Show version
+-j, --json            Output JSON to stdout
+-d, --depth <n>       Pages to crawl (default: 10)
+-s, --skip-ai         Skip AI analysis
+-t, --timeout <ms>    Page load timeout (default: 30000)
+--api-key <key>       AI API key
+-o, --output <dir>    Report output dir (default: tmp)
+--no-save             Skip auto-saving report
 ```
 
-## AI Analysis
+## AI Configuration
 
-For deeper content quality assessment, configure AI API in `.env`:
+Supports any OpenAI-compatible API (DeepSeek, OpenAI, Moonshot, local LLM, etc.).
 
 ```bash
 cp .env.example .env
-# Edit .env and set AI_API_KEY, AI_API_BASE, AI_MODEL
+# Edit .env:
+#   AI_API_KEY=sk-xxx
+#   AI_API_BASE=https://api.deepseek.com
+#   AI_MODEL=deepseek-chat
 ```
 
-Compatible with any OpenAI-format API: DeepSeek, OpenAI, Moonshot, local LLM, etc.
-
-Or pass the key directly:
+Or pass directly:
 
 ```bash
 adsense-check https://example.com --api-key sk-xxx...
 ```
 
-## Exit codes
+## Report Output
+
+### Terminal Report
+
+```
+  AdSense Checklist Report
+  Website: https://example.com
+
+  Content Quality
+    ✔ [PASS] 各页面正文占比正常
+    ✔ [PASS] 首页正文内容充足 (2,340 字)
+
+  ...
+
+  Page Details (5 pages analyzed)
+    ✔ /
+       正文 92% (2,340/2,540 字)
+    ⚠ /blog/old-post
+       正文 25% (80/320 字)
+       ! 正文占比仅 25%，大量模板元素
+       ✘ AI: 内容过于单薄，缺乏实质性信息
+         → 增加至少 500 字的原创分析内容
+
+  Score: 18/21
+  Status: NOT READY — 1 项失败需要修复
+```
+
+### JSON Report
+
+Full structured data including per-page details, saved automatically to `tmp/`.
+
+## Exit Codes
 
-- `0` — No failures (ready or mostly ready)
-- `1` — Has failures (not ready)
-- `2` — Error (invalid URL, network failure, etc.)
+| Code | Meaning |
+|------|---------|
+| 0 | No failures (READY or MOSTLY READY) |
+| 1 | Has failures (NOT READY) |
+| 2 | Runtime error |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcreate/adsense-check",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Check if a website meets Google AdSense review requirements",
   "homepage": "https://cloudcreate.ai",
   "repository": {