@yoonion/mimi-seed-mcp 0.21.1 → 0.21.3

package/README.md

@@ -128,7 +128,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 ---
 
 <!-- generated:readme-tools-heading:start — edit scripts/docs-spec.mjs, then npm run plugin:sync -->
-## 제공 도구 (150+ 개 · 22개 영역)
+## 제공 도구 (150+ 개 · 23개 영역)
 <!-- generated:readme-tools-heading:end -->
 
 <!-- generated:readme-tools-table:start — edit scripts/docs-spec.mjs, then npm run plugin:sync -->
@@ -142,6 +142,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | Jenkins (크리덴셜 + 잡 + 빌드) | 13 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_create_job` / `jenkins_update_job` / `jenkins_trigger_build` |
 | GA4 (Google Analytics 4) | 8 | `ga4_create_property` / `ga4_create_data_stream` / `ga4_plan_bigquery_link` / `ga4_create_bigquery_link` / `ga4_run_report` |
 | Search Console | 6 | `gsc_inspect_url` / `gsc_search_analytics` / `gsc_submit_sitemap` |
+| 네이버 서치어드바이저 | 2 | `naver_check_page` / `naver_indexnow_submit` |
 | Google Ads | 6 | `googleads_list_campaigns` / `googleads_get_uac_report` / `googleads_get_campaign_report` |
 | Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |
 | Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |

package/assets/agent-guide.md

@@ -78,7 +78,7 @@ row for the job; batching two rows in one `select:` call is fine.
 | App Store weekly growth insight | `select:appstore_get_weekly_insight,appstore_get_sales_report` |
 | AdMob | `select:admob_list_accounts,admob_list_apps,admob_create_app,admob_create_ad_unit,admob_list_ad_units,admob_get_today_earnings,admob_get_report` |
 | Google Ads (UAC) | `select:googleads_config_status,googleads_save_config,googleads_list_accessible_customers,googleads_list_campaigns,googleads_get_campaign_report,googleads_get_uac_report` |
-| Search Console | `select:gsc_list_sites,gsc_list_sitemaps,gsc_get_sitemap,gsc_submit_sitemap,gsc_inspect_url,gsc_search_analytics` |
+| Search indexing (Search Console / Naver) | `select:gsc_list_sites,gsc_list_sitemaps,gsc_get_sitemap,gsc_submit_sitemap,gsc_inspect_url,gsc_search_analytics,naver_check_page,naver_indexnow_submit` |
 | Social posting (Facebook / Instagram / Threads) | `select:facebook_current_config,facebook_save_config,facebook_list_pages,facebook_get_page,facebook_post_photo,facebook_post_multi_photo,instagram_save_config,instagram_get_account,instagram_post_image,instagram_post_carousel,threads_current_config,threads_save_config,threads_refresh_token,threads_get_account,threads_post,threads_post_video,threads_post_carousel` |
 | TikTok Business video publish | `select:tiktok_business_auth_status,tiktok_business_get_account,tiktok_business_get_video_settings,tiktok_business_plan_video_post,tiktok_business_publish_video,tiktok_business_get_publish_status,tiktok_business_list_publish_audits` |
 | Jenkins credentials + jobs | `select:jenkins_status,jenkins_save_config,jenkins_list_credentials,jenkins_create_credential,jenkins_delete_credential,jenkins_upload_keystore,jenkins_upload_playstore_sa,jenkins_list_jobs,jenkins_get_job_config,jenkins_create_job,jenkins_update_job` |

package/dist/googleads/config.d.ts

@@ -3,8 +3,11 @@ export interface GoogleAdsConfig {
     customerId: string;
     loginCustomerId?: string;
 }
-/** 하이픈 제거 (API는 숫자만 허용) */
-export declare function normalizeCustomerId(id: string): string;
+/**
+ * 하이픈 제거 (API는 숫자만 허용). 손으로 적은 설정 파일엔 따옴표 없는 숫자(`"customerId": 1234567890`)도
+ * 오므로 숫자도 받는다 — 안 그러면 `.replace` 가 던져 "설정 없음" 으로 읽힌다.
+ */
+export declare function normalizeCustomerId(id: string | number): string;
 export declare function saveConfig(cfg: GoogleAdsConfig): void;
 export declare function loadConfig(): GoogleAdsConfig | null;
 export declare function requireConfig(): GoogleAdsConfig;

package/dist/googleads/config.js

@@ -4,9 +4,12 @@ import os from 'node:os';
 import { writeCredentialJson } from '#core/atomic-write.js';
 const CONFIG_DIR = path.join(os.homedir(), '.mimi-seed');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'google-ads.json');
-/** 하이픈 제거 (API는 숫자만 허용) */
+/**
+ * 하이픈 제거 (API는 숫자만 허용). 손으로 적은 설정 파일엔 따옴표 없는 숫자(`"customerId": 1234567890`)도
+ * 오므로 숫자도 받는다 — 안 그러면 `.replace` 가 던져 "설정 없음" 으로 읽힌다.
+ */
 export function normalizeCustomerId(id) {
-    return id.replace(/-/g, '');
+    return String(id).replace(/-/g, '');
 }
 export function saveConfig(cfg) {
     const normalized = {
@@ -16,6 +19,14 @@ export function saveConfig(cfg) {
     };
     writeCredentialJson(CONFIG_PATH, normalized);
 }
+/** 손으로 적은 ID 는 문자열이거나 따옴표 없는 정수다. 그 밖(빈 값 · 객체 · 소수)은 설정이 아니다. */
+function readCustomerId(value) {
+    if (typeof value === 'string' && value.trim())
+        return normalizeCustomerId(value.trim());
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value > 0)
+        return normalizeCustomerId(value);
+    return null;
+}
 export function loadConfig() {
     if (!fs.existsSync(CONFIG_PATH))
         return null;
@@ -23,13 +34,15 @@ export function loadConfig() {
         const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
         // 읽기 시점에도 정규화 — 하이픈 포함 값이 손으로 적히거나 구버전이 쓴 경우에도
         // URL/login-customer-id 헤더가 항상 숫자만 포함하도록 보장 (write 경로 의존 제거).
-        return {
-            ...cfg,
-            customerId: normalizeCustomerId(cfg.customerId),
-            loginCustomerId: cfg.loginCustomerId
-                ? normalizeCustomerId(cfg.loginCustomerId)
-                : undefined,
-        };
+        const customerId = readCustomerId(cfg.customerId);
+        if (typeof cfg.developerToken !== 'string' || !cfg.developerToken || !customerId)
+            return null;
+        // 비어 있지 않은 loginCustomerId 가 이상하면 조용히 버리지 않는다 — MCC 헤더 없이 호출하면 엉뚱한 권한 오류가 난다.
+        const hasLogin = cfg.loginCustomerId !== undefined && cfg.loginCustomerId !== null && cfg.loginCustomerId !== '';
+        const loginCustomerId = hasLogin ? readCustomerId(cfg.loginCustomerId) : undefined;
+        if (loginCustomerId === null)
+            return null;
+        return { ...cfg, developerToken: cfg.developerToken, customerId, loginCustomerId };
     }
     catch {
         return null;

package/dist/googleads/errors.js

@@ -1,29 +1,37 @@
 /** Preserve provider diagnostics without exposing authentication material. */
 export function googleAdsError(status, body, secrets) {
     let message = `Google Ads API ${status}`;
+    let parsed;
     try {
-        const parsed = JSON.parse(body);
-        const error = (Array.isArray(parsed) ? parsed[0] : parsed)?.error;
-        if (typeof error?.message === 'string')
-            message += `: ${error.message}`;
-        for (const detail of Array.isArray(error?.details) ? error.details : []) {
-            for (const item of Array.isArray(detail.errors) ? detail.errors : []) {
-                const codes = item.errorCode && typeof item.errorCode === 'object'
-                    ? Object.entries(item.errorCode).map(([key, value]) => `${key}=${String(value)}`).join(', ')
-                    : '';
-                message += `\n${codes}${typeof item.message === 'string' ? `: ${item.message}` : ''}`;
-            }
-            for (const item of Array.isArray(detail.fieldViolations) ? detail.fieldViolations : []) {
-                message += `\n${String(item.field ?? '')}: ${String(item.description ?? '')}`;
-            }
-            if (typeof detail.requestId === 'string')
-                message += `\nrequestId=${detail.requestId}`;
-        }
+        parsed = JSON.parse(body);
     }
     catch {
         // HTML/proxy bodies can contain arbitrary data; do not echo them.
+        parsed = undefined;
         message += ': non-JSON response';
     }
+    // Only the parse decides "non-JSON": a JSON body with odd entries (`details: [null]`) is walked
+    // null-safely instead of throwing into the non-JSON branch and mislabelling a real provider error.
+    const error = (Array.isArray(parsed) ? parsed[0] : parsed)?.error;
+    if (typeof error?.message === 'string')
+        message += `: ${error.message}`;
+    for (const detail of Array.isArray(error?.details) ? error.details : []) {
+        for (const item of Array.isArray(detail?.errors) ? detail.errors : []) {
+            if (!item || typeof item !== 'object')
+                continue;
+            const codes = item?.errorCode && typeof item.errorCode === 'object'
+                ? Object.entries(item.errorCode).map(([key, value]) => `${key}=${String(value)}`).join(', ')
+                : '';
+            message += `\n${codes}${typeof item?.message === 'string' ? `: ${item.message}` : ''}`;
+        }
+        for (const item of Array.isArray(detail?.fieldViolations) ? detail.fieldViolations : []) {
+            if (!item || typeof item !== 'object')
+                continue;
+            message += `\n${String(item?.field ?? '')}: ${String(item?.description ?? '')}`;
+        }
+        if (typeof detail?.requestId === 'string')
+            message += `\nrequestId=${detail.requestId}`;
+    }
     for (const secret of secrets.filter(Boolean).sort((a, b) => b.length - a.length)) {
         message = message.split(secret).join('[REDACTED]');
     }

package/dist/googleads/setup-cli.js

@@ -104,7 +104,7 @@ async function main() {
     console.log(M.probing);
     try {
         const customers = await listAccessibleCustomers(auth, cfg);
-        console.log(M.probeOk(customers.length));
+        console.log(M.probeOk(customers.resourceNames.length));
     }
     catch (e) {
         const msg = e instanceof Error ? e.message : String(e);

package/dist/googleads/tools.d.ts

@@ -5,7 +5,14 @@ export interface DateRange {
     startDate: string;
     endDate: string;
 }
-export declare function listAccessibleCustomers(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<any>;
+/**
+ * 응답은 배열이 아니라 `{ resourceNames: ['customers/<id>', …] }` 다 — 계정이 없으면 protobuf JSON 이
+ * 필드를 생략하므로 빈 배열로 채운다. 반환 타입을 고정해 두지 않으면 호출부가 `.length` 를 읽어도
+ * 컴파일러가 못 잡는다(setup-cli 가 "계정 undefined개" 를 찍었다).
+ */
+export declare function listAccessibleCustomers(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<{
+    resourceNames: string[];
+}>;
 export declare function listCampaigns(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<{
     id: string | undefined;
     name: string | undefined;

package/dist/googleads/tools.js

@@ -98,6 +98,11 @@ function microsToCurrency(micros) {
     return value / 1_000_000;
 }
 // ─── 접근 가능한 고객 목록 (API 연결 확인용) ─────────────────────
+/**
+ * 응답은 배열이 아니라 `{ resourceNames: ['customers/<id>', …] }` 다 — 계정이 없으면 protobuf JSON 이
+ * 필드를 생략하므로 빈 배열로 채운다. 반환 타입을 고정해 두지 않으면 호출부가 `.length` 를 읽어도
+ * 컴파일러가 못 잡는다(setup-cli 가 "계정 undefined개" 를 찍었다).
+ */
 export async function listAccessibleCustomers(auth, cfg) {
     const accessToken = await getAccessToken(auth);
     const url = `${BASE}/customers:listAccessibleCustomers`;
@@ -109,7 +114,20 @@ export async function listAccessibleCustomers(auth, cfg) {
     if (!res.ok) {
         throw googleAdsError(res.status, text, [accessToken, cfg.developerToken]);
     }
-    return JSON.parse(text);
+    // SyntaxError 메시지는 본문 앞부분을 그대로 싣는다 — search() 와 같이 프록시 본문을 노출하지 않는다.
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new Error('Google Ads returned invalid JSON.');
+    }
+    // search() 와 같이 200 + error 본문도 거절한다 — 안 그러면 setup 이 "계정 0개" 로 저장해 버린다.
+    const names = isRecord(json) && !('error' in json) ? json.resourceNames ?? [] : null;
+    if (!Array.isArray(names) || names.some((name) => typeof name !== 'string')) {
+        throw new Error('Google Ads returned an invalid accessible-customers response.');
+    }
+    return { resourceNames: names };
 }
 // ─── 캠페인 목록 ─────────────────────────────────────────────
 export async function listCampaigns(auth, cfg) {

package/dist/lib/tool-registrar.js

@@ -44,6 +44,7 @@ const BRAND_PREFIXES = [
     ['bigquery_', 'BigQuery'],
     ['ga4_', 'GA4'],
     ['gsc_', 'Search Console'],
+    ['naver_', 'Naver'],
     ['googleads_', 'Google Ads'],
     ['facebook_', 'Facebook'],
     ['instagram_', 'Instagram'],
@@ -55,7 +56,7 @@ const BRAND_PREFIXES = [
     ['android_', 'Android'],
 ];
 const WORD_CASE = {
-    iap: 'IAP', ios: 'iOS', sa: 'SA', url: 'URL', uac: 'UAC', ai: 'AI', iam: 'IAM', ga4: 'GA4',
+    iap: 'IAP', ios: 'iOS', sa: 'SA', url: 'URL', uac: 'UAC', ai: 'AI', iam: 'IAM', ga4: 'GA4', indexnow: 'IndexNow',
     playstore: 'Play Store', appstore: 'App Store', bigquery: 'BigQuery', youtube: 'YouTube',
 };
 /** `playstore_submit_release` → `Play Store: Submit release`. */

package/dist/naver/robots.d.ts

@@ -0,0 +1,44 @@
+/**
+ * robots.txt 해석 (RFC 9309) — 네이버 검색로봇(Yeti)이 한 경로를 긁을 수 있는지 판정한다.
+ *
+ * 순수 함수만 둔다(네트워크 없음). 판정 규칙:
+ *  - 크롤러 토큰과 같은 `User-agent` 그룹이 있으면 그 그룹(여러 개면 합친다)만, 없으면 `*` 그룹을 쓴다.
+ *    `Yeti` 그룹이 따로 있으면 `*` 의 규칙은 Yeti 에게 **적용되지 않는다** — 흔한 오해다.
+ *    `User-agent: Yeti/1.1` 처럼 버전이 붙어도 제품 토큰(`[A-Za-z_-]+`)만 비교한다.
+ *  - 규칙은 가장 긴 패턴이 이기고, 길이가 같으면 allow 가 이긴다. `*` 와 닫는 `$` 를 지원한다.
+ *  - 값이 빈 `Disallow:` 는 규칙이 아니다(전부 허용).
+ *  - 비교 전에 패턴과 경로를 같은 퍼센트 인코딩으로 맞춘다 — `Disallow: /블로그` 는 `/%EB%B8%94…` 를 막는다.
+ *
+ * 매칭은 정규식이 아니라 선형 와일드카드 매처다. robots.txt 는 **점검 대상 사이트가 쓴 입력**이라
+ * `/*a*a*a…b` 같은 패턴으로 정규식 백트래킹을 폭발시켜 stdio 서버 전체를 멈출 수 있다.
+ */
+export declare const NAVER_CRAWLER_TOKEN = "yeti";
+export interface RobotsRule {
+    allow: boolean;
+    pattern: string;
+}
+export interface RobotsGroup {
+    agents: string[];
+    rules: RobotsRule[];
+}
+export interface ParsedRobots {
+    groups: RobotsGroup[];
+    sitemaps: string[];
+}
+export interface RobotsVerdict {
+    allowed: boolean;
+    /** 판정에 쓴 그룹 — 'yeti' 전용, '*', 또는 해당 그룹 없음. */
+    group: 'crawler' | 'wildcard' | 'none';
+    /** 판정을 결정한 규칙. 없으면 기본 허용. */
+    matchedRule?: RobotsRule;
+}
+export declare function parseRobots(text: string): ParsedRobots;
+/** 비ASCII 는 UTF-8 퍼센트 인코딩, 기존 `%xx` 는 대문자 16진수로 — 패턴과 경로를 같은 표기로 맞춘다. */
+export declare function normalizeRobotsPath(value: string): string;
+/**
+ * `*`(0자 이상)와 닫는 `$`(끝 고정)만 있는 와일드카드 매칭. 앞쪽은 항상 고정(접두어 매칭).
+ * 투 포인터 백트래킹이라 최악 O(패턴 × 경로) — 정규식처럼 지수적으로 터지지 않는다.
+ */
+export declare function robotsPatternMatches(pattern: string, path: string): boolean;
+/** `path` 는 경로 + 쿼리(`/a?b=1`). 크롤러 토큰은 소문자로 비교한다. */
+export declare function isAllowed(robots: ParsedRobots, path: string, crawler?: string): RobotsVerdict;

package/dist/naver/robots.js

@@ -0,0 +1,126 @@
+/**
+ * robots.txt 해석 (RFC 9309) — 네이버 검색로봇(Yeti)이 한 경로를 긁을 수 있는지 판정한다.
+ *
+ * 순수 함수만 둔다(네트워크 없음). 판정 규칙:
+ *  - 크롤러 토큰과 같은 `User-agent` 그룹이 있으면 그 그룹(여러 개면 합친다)만, 없으면 `*` 그룹을 쓴다.
+ *    `Yeti` 그룹이 따로 있으면 `*` 의 규칙은 Yeti 에게 **적용되지 않는다** — 흔한 오해다.
+ *    `User-agent: Yeti/1.1` 처럼 버전이 붙어도 제품 토큰(`[A-Za-z_-]+`)만 비교한다.
+ *  - 규칙은 가장 긴 패턴이 이기고, 길이가 같으면 allow 가 이긴다. `*` 와 닫는 `$` 를 지원한다.
+ *  - 값이 빈 `Disallow:` 는 규칙이 아니다(전부 허용).
+ *  - 비교 전에 패턴과 경로를 같은 퍼센트 인코딩으로 맞춘다 — `Disallow: /블로그` 는 `/%EB%B8%94…` 를 막는다.
+ *
+ * 매칭은 정규식이 아니라 선형 와일드카드 매처다. robots.txt 는 **점검 대상 사이트가 쓴 입력**이라
+ * `/*a*a*a…b` 같은 패턴으로 정규식 백트래킹을 폭발시켜 stdio 서버 전체를 멈출 수 있다.
+ */
+export const NAVER_CRAWLER_TOKEN = 'yeti';
+/** `Yeti/1.1 (+…)` → `yeti`. `*` 는 그대로. */
+function agentToken(value) {
+    if (value.startsWith('*'))
+        return '*';
+    return (/^[a-z_-]+/i.exec(value)?.[0] ?? value).toLowerCase();
+}
+export function parseRobots(text) {
+    const groups = [];
+    const sitemaps = [];
+    let current = null;
+    // 연속된 User-agent 줄은 한 그룹을 공유한다. 규칙이 나온 뒤의 User-agent 는 새 그룹.
+    let collectingAgents = false;
+    for (const raw of (text.charCodeAt(0) === 0xfeff ? text.slice(1) : text).split(/\r\n|\r|\n/)) {
+        const hash = raw.indexOf('#');
+        const line = (hash === -1 ? raw : raw.slice(0, hash)).trim();
+        const sep = line.indexOf(':');
+        if (sep <= 0)
+            continue;
+        const field = line.slice(0, sep).trim().toLowerCase();
+        const value = line.slice(sep + 1).trim();
+        if (field === 'sitemap') {
+            if (value)
+                sitemaps.push(value);
+            continue;
+        }
+        if (field === 'user-agent') {
+            if (!current || !collectingAgents) {
+                current = { agents: [], rules: [] };
+                groups.push(current);
+            }
+            current.agents.push(agentToken(value));
+            collectingAgents = true;
+            continue;
+        }
+        if (field === 'allow' || field === 'disallow') {
+            collectingAgents = false;
+            if (!current || !value)
+                continue; // 그룹 밖 규칙, 빈 Disallow 는 무시
+            current.rules.push({ allow: field === 'allow', pattern: value });
+        }
+    }
+    return { groups, sitemaps };
+}
+/** 비ASCII 는 UTF-8 퍼센트 인코딩, 기존 `%xx` 는 대문자 16진수로 — 패턴과 경로를 같은 표기로 맞춘다. */
+export function normalizeRobotsPath(value) {
+    return value
+        .replace(/%[0-9a-f]{2}/gi, (m) => m.toUpperCase())
+        .replace(/[\u0080-￿]+/g, (chunk) => {
+        try {
+            return encodeURIComponent(chunk);
+        }
+        catch {
+            return chunk; // 짝 없는 서로게이트 — 그대로 둔다
+        }
+    });
+}
+/**
+ * `*`(0자 이상)와 닫는 `$`(끝 고정)만 있는 와일드카드 매칭. 앞쪽은 항상 고정(접두어 매칭).
+ * 투 포인터 백트래킹이라 최악 O(패턴 × 경로) — 정규식처럼 지수적으로 터지지 않는다.
+ */
+export function robotsPatternMatches(pattern, path) {
+    const anchored = pattern.endsWith('$');
+    // `$` 가 없으면 접두어 매칭 = 끝에 `*` 가 붙은 것과 같다.
+    const p = anchored ? pattern.slice(0, -1) : `${pattern}*`;
+    let i = 0;
+    let j = 0;
+    let star = -1;
+    let mark = 0;
+    while (i < path.length) {
+        if (j < p.length && p[j] === '*') {
+            star = j++;
+            mark = i;
+        }
+        else if (j < p.length && p[j] === path[i]) {
+            i++;
+            j++;
+        }
+        else if (star !== -1) {
+            j = star + 1;
+            i = ++mark;
+        }
+        else {
+            return false;
+        }
+    }
+    while (j < p.length && p[j] === '*')
+        j++;
+    return j === p.length;
+}
+/** `path` 는 경로 + 쿼리(`/a?b=1`). 크롤러 토큰은 소문자로 비교한다. */
+export function isAllowed(robots, path, crawler = NAVER_CRAWLER_TOKEN) {
+    const token = crawler.toLowerCase();
+    const own = robots.groups.filter((g) => g.agents.includes(token));
+    const wildcard = robots.groups.filter((g) => g.agents.includes('*'));
+    const [groups, group] = own.length > 0
+        ? [own, 'crawler']
+        : wildcard.length > 0 ? [wildcard, 'wildcard'] : [[], 'none'];
+    const target = normalizeRobotsPath(path);
+    let best;
+    let bestLength = -1;
+    for (const rule of groups.flatMap((g) => g.rules)) {
+        const pattern = normalizeRobotsPath(rule.pattern);
+        if (!robotsPatternMatches(pattern, target))
+            continue;
+        if (pattern.length > bestLength || (pattern.length === bestLength && rule.allow && !best?.allow)) {
+            best = rule;
+            bestLength = pattern.length;
+        }
+    }
+    return { allowed: best ? best.allow : true, group, ...(best ? { matchedRule: best } : {}) };
+}

package/dist/naver/tools.d.ts

@@ -0,0 +1,127 @@
+import { type RobotsVerdict } from './robots.js';
+/**
+ * 네이버 서치어드바이저 — 검색 노출·색인 도구.
+ *
+ * 서치어드바이저에는 **공개 웹마스터 API 가 없다**(사이트 등록·사이트맵/RSS 제출·리포트는 콘솔 전용).
+ * 자동화할 수 있는 면은 두 가지뿐이라 그것만 다룬다:
+ *  - IndexNow: 네이버가 참여 엔진이다. 새/수정/삭제 URL 을 즉시 알린다. 인증 = 사이트에 올린 키 파일.
+ *  - 크롤러 관점 점검: 네이버 검색로봇(Yeti)이 보는 robots.txt·상태 코드·리다이렉트·메타 태그를 확인한다.
+ * 어느 쪽도 `~/.mimi-seed/` 자격증명을 쓰지 않는다.
+ *
+ * 점검 대상 사이트의 응답(HTML·robots.txt·헤더)은 **적대적 입력**으로 다룬다: 본문은 상한까지만 읽고,
+ * 파싱은 선형 스캔으로만 한다. 정규식 백트래킹이나 무한 버퍼링 한 번이면 stdio 서버 전체가 멈춘다.
+ */
+/** 네이버가 공개한 검색로봇 User-Agent. UA 로 봇을 막는 서버를 잡아내려고 그대로 보낸다. */
+export declare const YETI_USER_AGENT = "Mozilla/5.0 (compatible; Yeti/1.1; +https://naver.me/spd)";
+/** indexnow.org/searchengines.json 에 등록된 네이버 엔드포인트. */
+export declare const NAVER_INDEXNOW_ENDPOINT = "https://searchadvisor.naver.com/indexnow";
+/** IndexNow 프로토콜: POST 1회 최대 URL 수. */
+export declare const INDEXNOW_MAX_URLS = 10000;
+/** IndexNow 프로토콜: 8–128자, 영문·숫자·대시. */
+export declare const INDEXNOW_KEY_PATTERN: RegExp;
+/** RFC 9309: 크롤러는 robots.txt 를 최소 500 KiB 까지 해석해야 한다. 그 이상은 버린다. */
+export declare const ROBOTS_MAX_BYTES: number;
+/** HTML 은 이만큼만 읽는다 — head·본문 추정에는 충분하고 메모리는 묶인다. */
+export declare const HTML_MAX_BYTES: number;
+/**
+ * 응답 본문을 `maxBytes` 까지만 읽고 나머지는 끊는다. 인코딩은 content-type 의 charset
+ * (EUC-KR 등 레거시 한국어 페이지 포함), 모르면 UTF-8. BOM 은 TextDecoder 가 벗긴다.
+ */
+export declare function readCapped(res: Response, maxBytes: number): Promise<{
+    text: string;
+    truncated: boolean;
+}>;
+export interface PageHead {
+    title?: string;
+    description?: string;
+    canonical?: string;
+    /** `<base href>` — 상대 canonical 을 풀 때 쓴다. */
+    base?: string;
+    lang?: string;
+    og: {
+        title?: string;
+        description?: string;
+        image?: string;
+        url?: string;
+    };
+    /** `<meta name="robots">` 와 `<meta name="yeti">` 의 지시어(소문자). */
+    robots: string[];
+    naverSiteVerification: boolean;
+    /** script/style 을 뺀 원본 HTML 의 보이는 글자 수. */
+    textLength: number;
+    scriptCount: number;
+}
+export declare function decodeEntities(value: string): string;
+/** 속성 문자열 파서. HTML 처럼 같은 이름은 **처음 것**이 이긴다. */
+export declare function parseAttrs(src: string): Record<string, string>;
+export declare function parseHead(html: string): PageHead;
+export interface XRobots {
+    /** 이 크롤러에 확실히 적용되는 지시어. */
+    applies: string[];
+    /**
+     * 다른 봇 접두어(`googlebot: …`) 뒤에 콤마로 이어진 지시어. 같은 헤더의 연속이면 그 봇 전용이지만,
+     * 헤더가 여러 개면 fetch 가 `, ` 로 합쳐 버려 **접두어 없는 별도 헤더**였을 수도 있다 — 구분할 수 없다.
+     */
+    ambiguous: string[];
+}
+/**
+ * `X-Robots-Tag` 에서 이 크롤러에 적용되는 지시어를 뽑는다.
+ * UA 접두어가 없는 지시어는 모두에게, `yeti: …` 는 Yeti 에게, `googlebot: …` 은 건너뛴다.
+ */
+export declare function xRobotsDirectives(header: string | null, crawler?: string): XRobots;
+/** HTTP `Link: <…>; rel="canonical"` 헤더의 대상. */
+export declare function linkHeaderCanonical(header: string | null): string | undefined;
+export type IssueLevel = 'error' | 'warn' | 'info';
+export interface PageIssue {
+    level: IssueLevel;
+    code: string;
+    message: string;
+}
+export interface RedirectHop {
+    url: string;
+    status: number;
+    location: string;
+}
+export interface PageCheck {
+    url: string;
+    finalUrl: string;
+    status: number;
+    contentType: string | null;
+    redirects: RedirectHop[];
+    robotsTxt: {
+        url: string;
+        status: number | null;
+        verdict: RobotsVerdict | null;
+        sitemaps: string[];
+    };
+    directives: {
+        meta: string[];
+        header: string[];
+        headerAmbiguous: string[];
+    };
+    head: PageHead | null;
+    issues: PageIssue[];
+    summary: Record<IssueLevel, number>;
+}
+/** 네이버 검색로봇(Yeti) 관점에서 URL 1개를 점검한다. 쓰기 없음. */
+export declare function checkPage(input: string): Promise<PageCheck>;
+export interface IndexNowInput {
+    urls: string[];
+    key: string;
+    /** 키 파일이 사이트 루트(`/<key>.txt`)가 아닐 때만. */
+    keyLocation?: string;
+}
+export interface IndexNowResult {
+    endpoint: string;
+    status: number;
+    host: string;
+    keyLocation: string;
+    submitted: number;
+}
+/**
+ * 네이버 IndexNow 로 URL 변경을 알린다.
+ *
+ * 보내기 전에 키 파일을 직접 받아 key 와 같은지 확인한다 — 틀린 키는 엔드포인트가 403 만 돌려주고,
+ * 같은 호스트에 틀린 키로 반복 제출하면 스팸 판정 위험만 커진다. 같은 URL 재제출은 안전하다.
+ */
+export declare function submitIndexNow({ urls, key, keyLocation }: IndexNowInput): Promise<IndexNowResult>;