Initial commit with translated description
This commit is contained in:
121
INSTALL.md
Normal file
121
INSTALL.md
Normal file
@@ -0,0 +1,121 @@
|
||||
# Installation Guide
|
||||
|
||||
## 📦 Quick Installation
|
||||
|
||||
### 1. Clone or Download the Skill
|
||||
|
||||
```bash
|
||||
# Method 1: Using git clone (if public repo)
|
||||
git clone https://github.com/waisimon/playwright-scraper-skill.git
|
||||
cd playwright-scraper-skill
|
||||
|
||||
# Method 2: Download ZIP and extract
|
||||
# After downloading, enter the directory
|
||||
cd playwright-scraper-skill
|
||||
```
|
||||
|
||||
### 2. Install Dependencies
|
||||
|
||||
```bash
|
||||
# Install Playwright (recommended)
|
||||
npm install
|
||||
|
||||
# Install browser (Chromium)
|
||||
npx playwright install chromium
|
||||
```
|
||||
|
||||
### 3. Test
|
||||
|
||||
```bash
|
||||
# Quick test
|
||||
node scripts/playwright-simple.js https://example.com
|
||||
|
||||
# Test Stealth version
|
||||
node scripts/playwright-stealth.js https://example.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Advanced Installation
|
||||
|
||||
### Using with OpenClaw
|
||||
|
||||
If you're using OpenClaw, you can place this skill in the skills directory:
|
||||
|
||||
```bash
|
||||
# Assuming your OpenClaw workspace is at ~/.openclaw/workspace
|
||||
cp -r playwright-scraper-skill ~/.openclaw/workspace/skills/
|
||||
|
||||
# Then you can invoke it in OpenClaw
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Verify Installation
|
||||
|
||||
Run the example script:
|
||||
|
||||
```bash
|
||||
# Discuss.com.hk example (verified working)
|
||||
bash examples/discuss-hk.sh
|
||||
```
|
||||
|
||||
If you see output similar to this, installation is successful:
|
||||
|
||||
```
|
||||
🕷️ Starting Playwright Stealth scraper...
|
||||
📱 Navigating to: https://m.discuss.com.hk/#hot
|
||||
📡 HTTP Status: 200
|
||||
✅ Scraping complete!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Common Issues
|
||||
|
||||
### Issue: Playwright not found
|
||||
|
||||
**Error message:** `Error: Cannot find module 'playwright'`
|
||||
|
||||
**Solution:**
|
||||
```bash
|
||||
npm install
|
||||
npx playwright install chromium
|
||||
```
|
||||
|
||||
### Issue: Browser launch failed
|
||||
|
||||
**Error message:** `browserType.launch: Executable doesn't exist`
|
||||
|
||||
**Solution:**
|
||||
```bash
|
||||
npx playwright install chromium
|
||||
```
|
||||
|
||||
### Issue: Permission errors
|
||||
|
||||
**Error message:** `Permission denied`
|
||||
|
||||
**Solution:**
|
||||
```bash
|
||||
chmod +x scripts/*.js
|
||||
chmod +x examples/*.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 System Requirements
|
||||
|
||||
- **Node.js:** v18+ recommended
|
||||
- **OS:** macOS / Linux / Windows
|
||||
- **Disk Space:** ~500MB (including Chromium)
|
||||
- **RAM:** 2GB+ recommended
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Next Steps
|
||||
|
||||
After installation, check out:
|
||||
- [README.md](README.md) — Quick reference
|
||||
- [SKILL.md](SKILL.md) — Full documentation
|
||||
- [examples/](examples/) — Example scripts
|
||||
Reference in New Issue
Block a user