reborn-scrapegraph 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# reborn-scrapegraph
+
+영상에서 소개한 **ScrapeGraphAI** 를 실제로 쓸 수 있게 만드는 안내 스킬입니다.
+
+```bash
+npx --yes reborn-scrapegraph
+```
+
+## 이게 무엇을 하나
+
+`~/.claude/skills/scrapegraph-guide/` 에 안내 스킬 하나를 심습니다. 그게 전부입니다.
+
+**ScrapeGraphAI 자체는 저희가 깔지 않습니다.** `pip install scrapegraphai` 한 줄이면
+누구나 깝니다 — 그걸 대신 눌러 주는 건 아무 값도 안 만듭니다.
+
+## 그럼 무엇을 파나
+
+실제로 막히는 자리는 설치가 아니라 그 다음입니다.
+
+| 막히는 자리 | 이 패키지가 하는 일 |
+|---|---|
+| 「무료」인 줄 알고 깔았는데 LLM 키를 넣으래요 | **맨 앞에서** 무료의 범위를 말합니다 |
+| 에러도 안 나는데 결과가 비어 있어요 | `playwright install` 이 왔는지 **실제로 잽니다** |
+| 파이썬이 여러 개라 깐 쪽과 도는 쪽이 달라요 | 버전이 아니라 **`import` 로** 고릅니다 |
+
+```bash
+npx --yes reborn-scrapegraph --check      # 깔지 않고 이 컴퓨터만 잽니다
+```
+
+## 무료의 범위
+
+ScrapeGraphAI 는 두 가지 물건입니다.
+
+| | 오픈소스 라이브러리 | 매니지드 클라우드 API |
+|---|---|---|
+| 무엇 | `scrapegraphai` — 내가 돌립니다 | `scrapegraph-py` / `scrapegraph-js` |
+| 값 | **MIT · 무료** | **별개의 유료 서비스** |
+| LLM | **내 키** 또는 **Ollama 로컬** | 저쪽이 관리 |
+
+**「무료」는 왼쪽 칸 이야기입니다.** 라이브러리는 정말 무료이고, Ollama 로 로컬 모델을 쓰면
+한 푼도 안 듭니다 — 대신 내 PC 가 돕니다.
+
+## 안 깔고 직접 하실 수도 있습니다
+
+```bash
+pip install scrapegraphai
+playwright install
+```
+
+스킬 파일은 `skill/SKILL.md` 에 그대로 있습니다. 열어 보시고 손으로 옮기셔도 됩니다.
+
+## 명령
+
+| | |
+|---|---|
+| `npx --yes reborn-scrapegraph` | 안내 스킬을 깝니다 |
+| `--check` | 깔지 않고 이 컴퓨터 상태만 잽니다 |
+| `--dry-run` | 무엇을 할지 보여주기만 합니다 |
+| `--local` | 홈이 아니라 현재 폴더의 `.claude/skills` 에 깝니다 |
+| `--self-test` | 자기시험 (네트워크 안 씁니다) |
+
+## 밝혀 둡니다
+
+- **ScrapeGraphAI 는 ScrapeGraphAI 팀이 만든 별개의 MIT 오픈소스**이고 저희와 아무 관계가 없습니다.
+  이 패키지에는 그쪽 코드가 **한 줄도 들어 있지 않습니다.**
+- 저희가 심는 건 **저희가 쓴 안내 문서** 하나뿐입니다.
+- 긁어도 되는지는 대상 사이트의 이용약관·`robots.txt`·개인정보 규정에 달려 있습니다.
+  저희가 법률 판단을 대신 내리지 않습니다.
+- 수치(별·포크·라이선스)는 `skill/scrapegraph.json` 에 **확인일과 확인방법**을 달아 두었습니다.
+
+MIT · REBORN LABS

package/cli.mjs

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+/**
+ * scrapegraph-guide 설치기 — **영상이 말한 그 도구를 실제로 쓸 수 있게 만든다.**
+ *
+ *   npx --yes reborn-scrapegraph              안내 스킬을 깐다 (이게 전부다)
+ *   npx --yes reborn-scrapegraph --check      ★깔지 않고 **이 컴퓨터를 잰다**
+ *   npx --yes reborn-scrapegraph --dry-run    무엇을 할지 보여주기만 한다
+ *   npx --yes reborn-scrapegraph --local      홈(~/.claude/skills)이 아니라 현재 폴더에 깐다
+ *   npx --yes reborn-scrapegraph --self-test  자기시험 (네트워크 안 씀)
+ *
+ * ★★왜 라이브러리를 우리가 안 깔고 **안내 스킬**을 까나
+ *   ScrapeGraphAI 는 MIT 오픈소스 파이썬 라이브러리다. `pip install scrapegraphai` 한 줄이면
+ *   누구나 깐다 — 그걸 우리가 대신 눌러 주는 건 아무 값도 안 만든다.
+ *   실제로 막히는 자리는 설치가 아니라 **그 다음**이다:
+ *     ① 「무료」인 줄 알고 깔았는데 LLM 키를 넣으라고 한다
+ *     ② `playwright install` 을 안 해서 **에러 없이 빈 결과**가 돌아온다
+ *     ③ 파이썬이 여러 개라 깐 쪽과 도는 쪽이 다르다
+ *   우리가 파는 건 코드가 아니라 **그 셋을 미리 말해 주는 것**과 **실제로 재는 것**이다.
+ *
+ * ★★--check 가 이 설치기의 존재 이유다
+ *   말로 「되실 겁니다」 하지 않는다. `import` 를 실제로 돌려서 판정한다.
+ *   ★파이썬은 **버전 문자열이 아니라 import 로 고른다** [[python-interpreter-must-be-probed]] —
+ *     `python --version` 이 3.12 를 답해도 라이브러리는 3.11 에 깔려 있을 수 있다.
+ *
+ * ★★깔았다고 「됐다」고 하지 않는다.
+ *   복사는 조용히 실패한다(권한·경로·한글 홈디렉터리). 쓴 뒤 **다시 읽어 본다**
+ *   [[kit-update-selfcheck]].
+ */
+import { execFileSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { 링크, TAIL, 마지막 } from "./tail.mjs";
+
+const HOME = homedir();
+const 여기 = dirname(fileURLToPath(import.meta.url));
+const 인자 = process.argv.slice(2);
+const 확인만 = 인자.includes("--check");
+const 미리보기 = 인자.includes("--dry-run");
+const 여기에 = 인자.includes("--local");
+const 자기시험모드 = 인자.includes("--self-test");
+
+const c = { g: "\x1b[32m", r: "\x1b[31m", y: "\x1b[33m", d: "\x1b[90m", cy: "\x1b[36m", b: "\x1b[1m", 0: "\x1b[0m" };
+const 굵게 = (t) => String(t).replace(/\*\*(.+?)\*\*/g, `${c[0]}${c.b}$1${c[0]}${c.d}`);
+
+const 퍼널 = "scrape";
+const 스킬이름 = "scrapegraph-guide";
+const 원본 = join(여기, "skill");
+const 대상뿌리 = 여기에 ? join(process.cwd(), ".claude", "skills") : join(HOME, ".claude", "skills");
+const 대상 = join(대상뿌리, 스킬이름);
+
+/* ══ 원장 ═══════════════════════════════════════════════════════ */
+
+function 원장읽기() {
+  const p = join(원본, "scrapegraph.json");
+  if (!existsSync(p)) return { 됨: false, 이유: `원장이 없다 — ${p}` };
+  try { return { 됨: true, d: JSON.parse(readFileSync(p, "utf8")) }; }
+  catch (e) { return { 됨: false, 이유: `원장을 못 읽는다 — ${e.message}` }; }
+}
+
+/** ★조건 없이 단정하는 말. 홍보문에 섞이면 잡는다. [[kmong-no-unbounded-guarantee]] */
+const 금칙 = [/완전\s*무료/, /무제한/, /평생/, /100\s*%\s*보장/, /누구나\s*바로/, /무조건/,
+              /아무\s*사이트나/, /차단\s*없이/, /합법/];
+
+function 원장검사(d) {
+  const 문제 = [];
+  const 있나 = (v) => v !== undefined && v !== null && v !== "";
+
+  if (!있나(d?.확인일)) 문제.push("확인일이 없다 — 언제 잰 값인지 모르면 수치는 못 쓴다");
+  if (!있나(d?.확인방법)) 문제.push("확인방법이 없다 — 어디서 셌는지 없는 숫자는 지어낸 것과 구분이 안 된다");
+  for (const k of ["별", "포크", "관심"]) {
+    if (!Number.isFinite(d?.숫자?.[k])) 문제.push(`숫자.${k} 가 없다`);
+  }
+  if (d?.스킬?.라이선스 !== "MIT") 문제.push("라이선스가 MIT 가 아니다");
+  if (!/pip install/.test(d?.스킬?.설치 || "")) 문제.push("설치 명령이 없다");
+  if (!/playwright/.test(d?.스킬?.브라우저 || ""))
+    문제.push("브라우저 설치 줄이 없다 — 이게 빠지면 에러 없이 빈 결과가 나간다");
+
+  /* ★★이 킷의 존재 이유 — 「무료의 범위」가 비면 통과시키지 않는다.
+     이게 없으면 우리는 참고본과 똑같은 말만 하는 패키지가 된다. */
+  const 범위 = d?.["★무료의범위"];
+  if (!범위) 문제.push("★무료의범위 칸이 없다 — 이 패키지가 존재할 이유가 사라진다");
+  else {
+    if (!/무료/.test(범위.라이브러리 || "")) 문제.push("★무료의범위.라이브러리 가 무료라고 하지 않는다");
+    if (!/유료|별개/.test(범위.클라우드API || ""))
+      문제.push("★무료의범위.클라우드API 가 유료임을 말하지 않는다 — 그러면 범위를 안 나눈 것이다");
+    if (!Array.isArray(범위.비교표) || 범위.비교표.length < 3)
+      문제.push("★무료의범위.비교표 가 3줄 미만이다");
+  }
+
+  const 전문 = JSON.stringify(d);
+  for (const re of 금칙) if (re.test(전문)) 문제.push(`원장에 조건 없는 단정이 있다: ${re.source}`);
+  return 문제;
+}
+
+/* ══ 이 컴퓨터를 잰다 ══════════════════════════════════════════════
+   ★말로 판정하지 않는다. 실제로 돌린다. 못 돌리면 「모른다」고 한다 — 「된다」고 하지 않는다. */
+
+/** 파이썬 후보. ★버전 문자열이 아니라 **import 결과**로 고른다. */
+const 파이썬후보 = process.platform === "win32"
+  ? [["py", ["-3.12"]], ["py", ["-3.11"]], ["py", ["-3"]], ["python", []], ["python3", []]]
+  : [["python3", []], ["python", []]];
+
+function 파이썬돌리기(cmd, pre, code) {
+  try {
+    const out = execFileSync(cmd, [...pre, "-c", code], {
+      encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 20000,
+    });
+    return { 됨: true, 답: String(out).trim() };
+  } catch (e) {
+    return { 됨: false, 답: String(e.stderr || e.message || "").trim().split("\n").pop() };
+  }
+}
+
+function 환경재기() {
+  const 결과 = { 파이썬: null, 라이브러리: null, 플레이라이트: null, 브라우저: null, 키: [], 올라마: false };
+
+  for (const [cmd, pre] of 파이썬후보) {
+    const v = 파이썬돌리기(cmd, pre, "import sys;print(sys.version.split()[0])");
+    if (!v.됨) continue;
+    const lib = 파이썬돌리기(cmd, pre, "import scrapegraphai as s;print(getattr(s,'__version__','?'))");
+    /* ★★import 되는 쪽을 우선한다. 안 되면 첫 번째로 도는 인터프리터를 기록해 두고 계속 본다. */
+    if (!결과.파이썬 || lib.됨) {
+      결과.파이썬 = { 명령: [cmd, ...pre].join(" "), 버전: v.답 };
+      결과.라이브러리 = lib.됨 ? lib.답 : null;
+      const pw = 파이썬돌리기(cmd, pre, "import playwright;print('ok')");
+      결과.플레이라이트 = pw.됨;
+      if (pw.됨) {
+        /* ★「깔렸나」와 「브라우저를 받았나」는 다른 질문이다.
+           playwright 모듈만 있고 브라우저 바이너리가 없으면 **에러 없이 빈 결과**가 나온다. */
+        const br = 파이썬돌리기(cmd, pre,
+          "from playwright.sync_api import sync_playwright\n" +
+          "p=sync_playwright().start()\n" +
+          "print(p.chromium.executable_path)\n" +
+          "p.stop()");
+        결과.브라우저 = br.됨 && !!br.답 && existsSync(br.답.split("\n").pop().trim());
+      }
+    }
+    if (lib.됨) break;   // 라이브러리가 도는 인터프리터를 찾았으면 그게 정본이다
+  }
+
+  for (const k of ["OPENAI_API_KEY", "GROQ_API_KEY", "GOOGLE_API_KEY", "GEMINI_API_KEY", "AZURE_OPENAI_API_KEY"]) {
+    if (process.env[k]) 결과.키.push(k);
+  }
+  /* Ollama 는 떠 있어야 의미가 있다 — 깔렸는지가 아니라 **응답하는지**를 본다. */
+  try {
+    execFileSync(process.execPath, ["-e",
+      "fetch('http://localhost:11434/api/tags').then(r=>{process.exit(r.ok?0:1)}).catch(()=>process.exit(1))"],
+      { stdio: "ignore", timeout: 4000 });
+    결과.올라마 = true;
+  } catch { /* 안 떠 있다. 그게 답이다 */ }
+
+  return 결과;
+}
+
+function 환경보고(E, D) {
+  const 표 = (ok, 좋음, 나쁨) => `${ok ? c.g + "✓" : c.y + "…"} ${c[0]}${ok ? 좋음 : 나쁨}`;
+  console.log(`\n${c.b}이 컴퓨터를 실제로 재 봤습니다${c[0]}`);
+  console.log(`${c.d}${"─".repeat(58)}${c[0]}`);
+
+  if (!E.파이썬) {
+    console.log(`${c.r}✗${c[0]} 파이썬을 못 찾았습니다 — ScrapeGraphAI 는 파이썬 라이브러리입니다`);
+  } else {
+    console.log(`${c.g}✓${c[0]} 파이썬 ${E.파이썬.버전}  ${c.d}(${E.파이썬.명령})${c[0]}`);
+    console.log(`  ${표(!!E.라이브러리,
+      `scrapegraphai ${E.라이브러리}`,
+      `scrapegraphai 가 아직 없습니다  ${c.d}→ ${D.스킬.설치}${c[0]}`)}`);
+    console.log(`  ${표(!!E.플레이라이트, "playwright 모듈",
+      `playwright 모듈이 없습니다  ${c.d}→ pip install playwright${c[0]}`)}`);
+    if (E.플레이라이트) {
+      console.log(`  ${표(!!E.브라우저, "브라우저 엔진 내려받음",
+        `${c.y}브라우저 엔진이 없습니다${c[0]}  ${c.d}→ ${D.스킬.브라우저}${c[0]}`)}`);
+      if (!E.브라우저) {
+        console.log(`     ${c.y}★이게 빠지면 에러 없이 ${c.b}빈 결과${c[0]}${c.y}가 돌아옵니다.${c[0]}`);
+        console.log(`     ${c.d}자바스크립트로 그리는 사이트에서 본문이 통째로 비어 옵니다.${c[0]}`);
+      }
+    }
+  }
+
+  console.log("");
+  if (E.키.length) console.log(`${c.g}✓${c[0]} LLM 키 ${E.키.join(", ")}`);
+  else if (E.올라마) console.log(`${c.g}✓${c[0]} Ollama 가 떠 있습니다 ${c.d}(localhost:11434) — 키 없이 0원으로 돌립니다${c[0]}`);
+  else {
+    console.log(`${c.y}…${c[0]} LLM 키도 Ollama 도 못 찾았습니다`);
+    console.log(`  ${c.d}${굵게("라이브러리는 무료지만 **모델은 내 것**입니다.")}${c[0]}`);
+    console.log(`  ${c.d}둘 중 하나면 됩니다 — 내 API 키를 넣거나, Ollama 를 띄워 로컬로 돌리거나.${c[0]}`);
+  }
+  console.log(`${c.d}${"─".repeat(58)}${c[0]}`);
+}
+
+/* ══ 심기 ═══════════════════════════════════════════════════════ */
+
+function 심기() {
+  mkdirSync(대상, { recursive: true });
+  cpSync(원본, 대상, { recursive: true });
+  /* ★쓴 뒤 다시 읽는다 — 복사는 조용히 실패한다 [[kit-update-selfcheck]] */
+  const 문제 = [];
+  for (const f of readdirSync(원본)) {
+    const a = join(원본, f), b = join(대상, f);
+    if (!existsSync(b)) { 문제.push(`${f} 가 안 복사됐다`); continue; }
+    if (statSync(b).size !== statSync(a).size) 문제.push(`${f} 크기가 다르다 — 잘려 복사됐다`);
+  }
+  if (!문제.length) {
+    try { JSON.parse(readFileSync(join(대상, "scrapegraph.json"), "utf8")); }
+    catch { 문제.push("깐 원장이 JSON 으로 안 읽힌다"); }
+  }
+  return 문제;
+}
+
+/* ══ 자기시험 — 네트워크 안 씀 ══════════════════════════════════ */
+
+function 자기시험() {
+  const 나쁨 = [];
+  const L = 원장읽기();
+  if (!L.됨) { 나쁨.push(L.이유); return 나쁨; }
+  for (const m of 원장검사(L.d)) 나쁨.push(`원장: ${m}`);
+
+  if (!existsSync(join(원본, "SKILL.md"))) 나쁨.push("skill/SKILL.md 가 없다");
+  else {
+    const md = readFileSync(join(원본, "SKILL.md"), "utf8");
+    if (!/^---[\s\S]*?name:\s*scrapegraph-guide/m.test(md))
+      나쁨.push("SKILL.md 머리말의 name 이 scrapegraph-guide 가 아니다 — 클로드가 못 찾는다");
+    if (!/description:/.test(md)) 나쁨.push("SKILL.md 에 description 이 없다 — 발동하지 않는다");
+    if (!/playwright install/.test(md))
+      나쁨.push("SKILL.md 가 playwright install 을 말하지 않는다 — 「안 되는데요」의 절반이 그 줄이다");
+    if (!/Ollama/i.test(md)) 나쁨.push("SKILL.md 가 로컬(Ollama) 길을 말하지 않는다");
+    for (const re of 금칙) if (re.test(md)) 나쁨.push(`SKILL.md 에 조건 없는 단정: ${re.source}`);
+  }
+
+  /* ★검사기 자체를 양방향으로 본다 [[verifier-must-be-tested-both-ways]] */
+  const 좋은원장 = JSON.parse(JSON.stringify(L.d));
+  if (원장검사(좋은원장).length) 나쁨.push("자기시험 오탐: 멀쩡한 원장을 막는다");
+  const 나쁜원장 = JSON.parse(JSON.stringify(L.d));
+  delete 나쁜원장["★무료의범위"];
+  if (!원장검사(나쁜원장).length) 나쁨.push("자기시험 미탐: 무료의범위가 빠져도 통과한다");
+  const 나쁜원장2 = JSON.parse(JSON.stringify(L.d));
+  나쁜원장2.스킬.브라우저 = "";
+  if (!원장검사(나쁜원장2).length) 나쁨.push("자기시험 미탐: playwright 줄이 빠져도 통과한다");
+
+  return 나쁨;
+}
+
+/* ══ 끝난 뒤 한 칸 ═══════════════════════════════════════════════
+   규율: ① 끝난 뒤 딱 한 칸 · ② 못 깔았으면 안 띄운다 · ③ 파일을 안 남긴다
+         ④ 고지 블록 금지 · ⑤ 첫 줄은 방금 한 일에서 이어져야 한다 */
+function 꼬리() {
+  const T = TAIL[퍼널];
+  if (!T) return;
+  console.log("");
+  for (const l of T.이음) console.log(`${c.d}${굵게(l)}${c[0]}`);
+  console.log("");
+  console.log(`  ${c.b}${T.제목}${c[0]}  ${c.d}${T.한줄}${c[0]}`);
+  console.log(`  ${c.cy}${링크(퍼널)}${c[0]}`);
+  console.log("");
+  console.log(`${c.d}${마지막}${c[0]}`);
+}
+
+/* ══ 본체 ═══════════════════════════════════════════════════════ */
+
+if (자기시험모드) {
+  const 나쁨 = 자기시험();
+  if (나쁨.length) {
+    console.log(`${c.r}자기시험 실패${c[0]}`);
+    for (const m of 나쁨) console.log("  - " + m);
+    process.exit(1);
+  }
+  console.log(`${c.g}자기시험 통과${c[0]}`);
+  process.exit(0);
+}
+
+const L = 원장읽기();
+if (!L.됨) { console.log(`${c.r}✗ ${L.이유}${c[0]}`); process.exit(1); }
+const 원장문제 = 원장검사(L.d);
+if (원장문제.length) {
+  console.log(`${c.r}✗ 원장이 성하지 않다 — 깔지 않는다${c[0]}`);
+  for (const m of 원장문제) console.log("  - " + m);
+  process.exit(1);
+}
+const D = L.d;
+
+console.log("");
+console.log(`${c.b}ScrapeGraphAI${c[0]} ${c.d}— ${D.스킬.라이선스} · ${D.스킬.언어} · GitHub ★${D.숫자.별.toLocaleString("en-US")} (${D.확인일} 실측)${c[0]}`);
+
+/* ★★무엇이 무료인지를 **맨 앞에서** 말한다. 깔고 나서 막히는 자리가 여기라서다. */
+console.log("");
+console.log(`${c.d}${굵게("무료인 건 **라이브러리**입니다 — 내 컴퓨터에서 돌고 MIT 입니다.")}${c[0]}`);
+console.log(`${c.d}${굵게("**모델은 내 것**입니다 — 내 API 키를 쓰거나, Ollama 로 로컬로 돌리면 0원입니다.")}${c[0]}`);
+console.log(`${c.d}클라우드 API(scrapegraph-py/js)는 ${굵게("**별개의 유료 서비스**")}입니다.${c[0]}`);
+
+const E = 환경재기();
+환경보고(E, D);
+
+if (확인만) {
+  console.log(`${c.d}깔려면: npx --yes reborn-scrapegraph${c[0]}\n`);
+  process.exit(0);
+}
+
+if (미리보기) {
+  console.log(`${c.d}할 일:${c[0]}`);
+  console.log(`  ${스킬이름} → ${대상}`);
+  console.log(`${c.d}(--dry-run 이라 아무것도 안 했습니다)${c[0]}\n`);
+  process.exit(0);
+}
+
+const 문제 = 심기();
+if (문제.length) {
+  console.log(`\n${c.r}✗ 심다가 막혔습니다${c[0]}`);
+  for (const m of 문제) console.log("  - " + m);
+  console.log(`${c.d}권한이나 경로 문제일 수 있습니다. --local 로 현재 폴더에 깔아 보세요.${c[0]}\n`);
+  process.exit(1);
+}
+
+console.log(`\n${c.g}✓${c[0]} ${c.b}${스킬이름}${c[0]} 을 깔았습니다`);
+console.log(`  ${c.d}${대상}${c[0]}`);
+console.log("");
+console.log(`${c.d}클로드 코드를 ${굵게("**다시 시작**")}하면 잡힙니다. 그 뒤 이렇게 물어 보세요:${c[0]}`);
+console.log(`  ${c.cy}"이 페이지에서 제품명이랑 가격 뽑아줘"${c[0]}`);
+console.log("");
+console.log(`${c.d}지금 상태만 다시 재려면: ${c[0]}npx --yes reborn-scrapegraph --check`);
+
+꼬리();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "reborn-scrapegraph",
+  "version": "1.0.0",
+  "description": "영상에서 소개한 ScrapeGraphAI(MIT 오픈소스 파이썬 스크래퍼)를 실제로 쓸 수 있게 만드는 안내 스킬입니다. 무료인 건 라이브러리이고 모델은 내 키 또는 Ollama 라는 것을 먼저 말하고, playwright 브라우저 엔진이 왔는지·파이썬이 몇 개인지를 이 컴퓨터에서 직접 재 줍니다.",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "agent-skills",
+    "skill",
+    "scrapegraphai",
+    "scraping",
+    "web-scraping",
+    "crawler",
+    "playwright",
+    "ollama",
+    "korean"
+  ],
+  "homepage": "https://rebornlabs.kr/scrapegraph?utm_source=installer&utm_medium=cli&utm_campaign=scrape",
+  "bugs": {
+    "url": "https://mobility.rebornlabs.kr/cs"
+  },
+  "license": "MIT",
+  "author": "REBORN LABS",
+  "type": "module",
+  "bin": {
+    "reborn-scrapegraph": "cli.mjs"
+  },
+  "files": [
+    "cli.mjs",
+    "tail.mjs",
+    "skill/",
+    "README.md",
+    "안내스킬.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node cli.mjs --self-test",
+    "check": "node cli.mjs --check"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: scrapegraph-guide
+description: ScrapeGraphAI(MIT 오픈소스 파이썬 스크래퍼)로 웹페이지에서 구조화된 데이터를 뽑을 때 쓴다. 주소 한 줄과 "무엇을 뽑을지" 한 문장으로 JSON 을 받는 작업 — 경쟁사 가격표, 리드 목록, 기사 요지, 채용 조건 수집. 사용자가 "긁어와", "스크래핑", "크롤링", "이 사이트에서 뽑아줘", "scrapegraphai", "스크랩그래프" 라고 하거나, 웹에서 반복 수집이 필요한 일을 말할 때 발동한다. ★먼저 무엇이 무료이고 무엇이 유료인지, 그리고 지금 이 컴퓨터에서 무엇이 빠졌는지 말한다.
+---
+
+# ScrapeGraphAI — 주소 한 줄 + 원하는 것 한 문장
+
+## ★가장 먼저 말할 것 — 무엇이 무료인가
+
+ScrapeGraphAI 는 **두 가지 물건**이다. 이걸 안 나누면 사용자가 깔고 나서 막힌다.
+
+| | 오픈소스 라이브러리 | 매니지드 클라우드 API |
+|---|---|---|
+| 무엇 | `scrapegraphai` — **내가 돌리는 파이썬 라이브러리** | `scrapegraph-py` / `scrapegraph-js` — 남이 돌려 주는 호스팅 서비스 |
+| 어디서 도나 | 내 컴퓨터 | ScrapeGraphAI 클라우드 |
+| 값 | **MIT · 무료** | **별개의 유료 서비스** |
+| LLM | **내 키**(OpenAI·Groq·Gemini·Azure) 또는 **Ollama 로컬** | 저쪽이 관리 |
+| 브라우저 렌더링 | 내가 붙인다(Playwright) | 저쪽이 관리 |
+
+**「무료」는 왼쪽 칸 이야기다.** 라이브러리는 정말 무료이고, Ollama 로 로컬 모델을 쓰면
+**한 푼도 안 든다** — 대신 내 PC 가 돈다. 클라우드 키를 쓰면 그건 유료 서비스다.
+
+> 소개 영상들이 이 표를 화면에 띄우면서 「무료 오픈소스」라고만 말하는 경우가 많다.
+> 틀린 말은 아니다 — 다만 화면에 답이 떠 있는데 말하지 않았을 뿐이다.
+> 사용자가 깔고 나서 「키를 넣으래요」로 막히는 자리가 정확히 여기다.
+
+## ★두 번째로 할 것 — 지금 이 컴퓨터를 잰다
+
+말로 「되실 겁니다」 하지 않는다. **실제로 본다.**
+
+```bash
+python -c "import scrapegraphai, sys; print(scrapegraphai.__version__)"   # 라이브러리
+python -c "import playwright; print('playwright ok')"                     # 브라우저 엔진
+```
+
+★파이썬은 **여러 개가 깔려 있을 수 있다.** `python --version` 이 아니라 `import` 로 고른다
+— 버전만 보고 고르면 껍데기 인터프리터를 잡는다.
+
+```bash
+py -3.11 -c "import scrapegraphai"    # 되는 쪽이 정본이다
+py -3.12 -c "import scrapegraphai"
+```
+
+## 설치 — 두 줄이다. 한 줄이 아니다
+
+```bash
+pip install scrapegraphai
+playwright install
+```
+
+★**`playwright install` 이 빠지면 조용히 빈 결과가 나온다.** 에러가 안 난다 —
+자바스크립트로 그리는 사이트(요즘 대부분)에서 본문이 통째로 비어 돌아온다.
+「안 되는데요」의 절반이 이 한 줄이다. 설치 안내에서 빼지 마라.
+
+## 쓰는 법 — 스키마를 먼저 정한다
+
+```python
+from scrapegraphai.graphs import SmartScraperGraph
+
+graph = SmartScraperGraph(
+    prompt="제품명, 가격, 재고, 별점, 리뷰 수를 뽑아줘",
+    source="https://shop.example.com/item/1234",
+    config={
+        "llm": {"model": "openai/gpt-4o-mini", "api_key": "..."},
+        "verbose": False,
+    },
+)
+print(graph.run())
+```
+
+### 로컬로 완전 0원
+
+```python
+config = {
+    "llm": {"model": "ollama/llama3.1", "model_tokens": 8192,
+            "base_url": "http://localhost:11434"},
+    "embeddings": {"model": "ollama/nomic-embed-text",
+                   "base_url": "http://localhost:11434"},
+}
+```
+
+★Ollama 를 먼저 띄워 둬야 한다(`ollama serve`). 안 띄우면 연결 거부로 죽는다.
+
+### 그래프 고르기
+
+| 무엇을 하나 | 클래스 |
+|---|---|
+| 페이지 하나에서 구조화 데이터 | `SmartScraperGraph` |
+| 페이지 **여러 개**를 같은 스키마로 | `SmartScraperMultiGraph` |
+| 검색부터 해서 모아 오기 | `SearchGraph` |
+| 스크래핑 코드를 짜 달라고 하기 | `ScriptCreatorGraph` |
+
+## ★답할 때 지키는 것
+
+1. **무료의 범위를 먼저 말한다.** 라이브러리는 무료, 모델은 내 키 또는 로컬.
+2. **잰 것만 말한다.** 사용자 PC 에 뭐가 깔렸는지는 위 명령으로 **확인하고** 말한다.
+3. **`playwright install` 을 빠뜨리지 않는다.**
+4. **파이썬은 `import` 로 고른다.** 버전 문자열로 고르지 않는다.
+5. **긁어도 되는지는 사용자가 판단할 일이다.** 대상 사이트의 이용약관·`robots.txt`·
+   개인정보가 걸릴 수 있다는 것을 한 줄로 알린다. 법률 판단을 대신 내리지 않는다 —
+   「써도 됩니다」·「문제없습니다」로 끝내지 말고, 무엇을 확인해야 하는지를 말한다.
+6. **로그인 뒤 페이지·차단된 사이트는 안 된다고 말한다.** 우회 방법을 안내하지 않는다.
+
+## 숫자의 주인은 `scrapegraph.json` 하나다
+
+별 개수·라이선스·공급자 목록은 **원장에서만** 나온다. 여기 본문에 다시 적지 않는다 —
+두 곳에 적으면 두 곳이 서로 다른 말을 하기 시작한다.
+원장에는 **확인일과 확인방법**이 같이 있다. 확인일이 없는 숫자는 지어낸 것과 구분이 안 된다.

package/skill/scrapegraph.json

@@ -0,0 +1,55 @@
+{
+ "_doc": "ScrapeGraphAI 사실 원장 — 릴스·착지·DM·설치기가 **전부 이 파일 하나**를 본다. 지어낸 수치가 화면에 오르는 것을 막는다.",
+ "확인일": "2026-09-01",
+ "확인방법": "GitHub REST API(stargazers_count·forks_count·subscribers_count·license·language)로 저장소를 직접 조회하고, main 브랜치 README.md 원문을 내려받아 설치 명령·LLM 공급자·그래프 클래스·비교표를 직접 읽었다.",
+ "저장소": {
+  "주소": "https://github.com/ScrapeGraphAI/Scrapegraph-ai",
+  "설명": "Python scraper based on AI"
+ },
+ "숫자": {
+  "별": 30233,
+  "포크": 2999,
+  "관심": 178
+ },
+ "스킬": {
+  "라이선스": "MIT",
+  "언어": "Python",
+  "설치": "pip install scrapegraphai",
+  "브라우저": "playwright install"
+ },
+ "그래프": [
+  "SmartScraperGraph",
+  "SearchGraph",
+  "SpeechGraph",
+  "ScriptCreatorGraph",
+  "SmartScraperMultiGraph",
+  "ScriptCreatorMultiGraph"
+ ],
+ "LLM공급자": ["OpenAI", "Groq", "Azure", "Gemini", "MiniMax", "Ollama(로컬)"],
+
+ "★무료의범위": {
+  "_왜": "★★이 회차에서 우리가 참고본에 **더하는 한 줄**이다. 참고본은 이 비교표를 화면에 띄우고도 「무료 오픈소스」라고만 말한다. 틀린 말은 아니다 — 다만 화면에 답이 떠 있는데 말하지 않았을 뿐이다.",
+  "라이브러리": "MIT · 무료 · 내 컴퓨터에서 돈다",
+  "LLM": "★내 키를 쓴다. Ollama 로 로컬 모델을 쓰면 그것도 0원이다.",
+  "클라우드API": "scrapegraph-py / scrapegraph-js 는 **별개의 유료 호스팅 서비스**다. 라이브러리와 다른 물건이다.",
+  "원문근거": "README — ScrapeGraphAI comes in two flavours: this open-source library, which you run yourself, and the managed cloud API",
+  "비교표": [
+   ["What it is", "A Python library you run yourself", "A hosted cloud service you call via SDK"],
+   ["Where it runs", "Your own infrastructure (self-hosted)", "ScrapeGraphAI cloud"],
+   ["LLM", "Bring your own (OpenAI, Groq, Gemini, Azure, local via Ollama)", "Managed for you"],
+   ["Browser / JS rendering", "You configure it (Playwright)", "Managed (stealth, auto/fast/js modes)"]
+  ]
+ },
+
+ "★참고본이_말하지_않은_것": [
+  "★★「무료 오픈소스」는 **라이브러리 이야기**다. 화면에 띄운 비교표 오른쪽 칸(Managed API)은 유료 호스팅이고, 영상은 그 표를 띄우면서 그 구분을 말하지 않는다. 이 한 줄이 우리가 더하는 전부다.",
+  "★라이브러리를 돌리려면 **LLM 키가 필요하다.** 없으면 Ollama 로 로컬 모델을 쓴다 — 그러면 완전히 0원이지만 대신 내 PC 가 돈다.",
+  "★설치가 pip 한 줄로 끝나지 않는다 — playwright install 이 한 줄 더 있다. 이게 빠지면 자바스크립트로 그리는 사이트에서 조용히 빈 결과가 나온다."
+ ],
+
+ "MCP": {
+  "저장소": "https://github.com/ScrapeGraphAI/scrapegraph-mcp",
+  "라이선스": "MIT",
+  "주의": "★공식 MCP 서버는 **클라우드 API 키**를 쓴다. 무료 경로는 MCP 가 아니라 라이브러리다."
+ }
+}

package/tail.mjs

@@ -0,0 +1,24 @@
+/**
+ * 「끝난 뒤 한 칸」 문안 — **정본은 `skillpack/tail_copy.mjs` 다.**
+ * 사본이 여기 있는 이유는 하나뿐이다: npm 패키지는 폴더 밖을 import 할 수 없다.
+ * 고칠 일이 생기면 **정본을 먼저 고치고** 여기로 옮긴다. 반대로 하지 마라.
+ *
+ * 규율: ① 끝난 뒤 딱 한 칸 · ② 못 깔았으면 안 띄운다 · ③ 파일을 안 남긴다
+ *       ④ 고지 블록 금지 · ⑤ 첫 줄은 **방금 한 일에서 이어져야** 한다
+ * ★클로드킷·자비스 풀스택은 여기서 말하지 않는다 — 스킬팩 구매 이후다(2026-08-24 전략).
+ */
+export const 랜딩 = "https://rebornlabs.kr/skillpack";
+export const 링크 = (퍼널) => `${랜딩}?utm_source=installer&utm_medium=cli&utm_campaign=${퍼널}`;
+
+export const TAIL = {
+  scrape: {
+    이음: [
+      "방금 한 일은 **깔기 전에 재 본 것**입니다 — 파이썬이 몇 개인지, 브라우저 엔진이 왔는지, 모델은 어디서 오는지.",
+      "도구마다 이 세 가지가 다르고, 매번 이만큼 걸립니다. 문서에는 안 적혀 있으니까요.",
+    ],
+    제목: "리본랩스 스킬팩",
+    한줄: "같은 방식으로 골라 담은 48종을 한 줄로. 8,900원",
+  },
+};
+
+export const 마지막 = "목록과 직접 까는 명령까지 그 페이지에 그대로 적어 두었습니다. 안 사셔도 됩니다.";

package//354/225/210/353/202/264/354/212/244/355/202/254.md

@@ -0,0 +1,53 @@
+# 안내스킬 — `scrapegraph-guide`
+
+이 패키지가 `~/.claude/skills/scrapegraph-guide/` 에 심는 것.
+
+| 파일 | 무엇 |
+|---|---|
+| `SKILL.md` | 클로드가 읽는 안내. 답하는 순서가 여기 있다 |
+| `scrapegraph.json` | **원장.** 모든 숫자의 주인. 여기 없는 숫자는 말하지 않는다 |
+
+★심는 것은 이 폴더 하나뿐이다. **공유 안내스킬에는 손대지 않는다** —
+같은 파일을 여러 설치기가 덮는 사고를 애초에 안 만든다.
+
+## 왜 원장을 따로 두나
+
+숫자를 `SKILL.md` 본문에 적으면 두 곳이 서로 다른 말을 하기 시작한다.
+별 개수·라이선스·공급자 목록은 **한 곳에서만** 나온다. [[one-metric-one-owner]]
+
+원장에는 **확인일과 확인방법**이 반드시 있다. 없으면 설치기가 막는다.
+
+## ★이 킷의 존재 이유는 `★무료의범위` 다
+
+참고본(그리고 대부분의 소개 영상)은 「Open Source vs Managed API」 비교표를
+**화면에 띄우면서** 「무료 오픈소스」라고만 말한다. 틀린 말은 아니다 —
+화면에 답이 떠 있는데 말하지 않았을 뿐이다.
+
+깔고 나서 「키를 넣으래요」로 막히는 자리가 정확히 거기다.
+
+원장검사가 이걸 지킨다 — `★무료의범위` 가 비거나 클라우드 API 를 유료라고
+말하지 않으면 **통과시키지 않는다.** 그게 빠지면 이 패키지는 존재할 이유가 없다.
+
+## ★`--check` 는 판정을 우리가 하지 않는다
+
+「되실 겁니다」라고 말하지 않는다. `import` 를 **실제로 돌린다.**
+
+- 파이썬은 **버전 문자열이 아니라 import 로** 고른다 [[python-interpreter-must-be-probed]]
+- playwright 는 **모듈이 있나**와 **브라우저 엔진이 왔나**를 나눠 본다 —
+  후자가 없으면 **에러 없이 빈 결과**가 나온다. 이게 「안 되는데요」의 절반이다
+- Ollama 는 깔렸는지가 아니라 **응답하는지**를 본다
+
+## 안 되면 제일 먼저
+
+깐 다음 **클로드 코드를 껐다 켜세요.** 그래도 안 뜨면 이름을 직접 부르시고,
+그래도 없으면 지금 상태를 재 봅니다 — `npx --yes reborn-scrapegraph --check`
+
+---
+
+방금 한 일은 **깔기 전에 재 본 것**입니다 — 파이썬이 몇 개인지, 브라우저 엔진이 왔는지,
+모델은 어디서 오는지. 도구마다 이 세 가지가 다르고 문서에는 안 적혀 있습니다.
+
+**리본랩스 스킬팩** — 같은 방식으로 골라 담은 48종을 한 줄로. 8,900원
+https://rebornlabs.kr/skillpack?utm_source=installer&utm_medium=cli&utm_campaign=scrape
+
+목록과 직접 까는 명령까지 그 페이지에 그대로 적어 두었습니다. 안 사셔도 됩니다.