friday-mcp-v2 3.1.0 → 3.1.2

package/dist/mcp-server.js

@@ -16,6 +16,7 @@ import { readFileSync, statSync, realpathSync, appendFileSync, mkdirSync, exists
 import { execFile } from "node:child_process";
 import { resolve as resolvePath, sep, dirname, join as joinPath, extname } from "node:path";
 import { marked } from "marked";
+import { parse as parseHTML } from "node-html-parser";
 import os from "node:os";
 import { fileURLToPath } from "node:url";
 // package.json からバージョンを取得
@@ -457,6 +458,117 @@ function readHTMLFromFile(filePath, maxSizeBytes = 2 * 1024 * 1024) {
     return { html };
 }
 
+// ========================================
+// Markdown → Gutenberg Block Converter
+// ========================================
+
+function _convertHeading(node) {
+    const tag = node.tagName.toLowerCase();
+    const level = parseInt(tag[1]);
+    const attrs = level === 2 ? '' : ` {"level":${level}}`;
+    return `<!-- wp:heading${attrs} -->\n<${tag} class="wp-block-heading">${node.innerHTML}</${tag}>\n<!-- /wp:heading -->`;
+}
+
+function _convertParagraph(node) {
+    const img = node.querySelector('img');
+    if (img && node.childNodes.length === 1) {
+        return _convertImage(img);
+    }
+    return `<!-- wp:paragraph -->\n<p>${node.innerHTML}</p>\n<!-- /wp:paragraph -->`;
+}
+
+function _convertList(node) {
+    const tag = node.tagName.toLowerCase();
+    const ordered = tag === 'ol';
+    const attrs = ordered ? ' {"ordered":true}' : '';
+    const outerTag = ordered ? 'ol' : 'ul';
+    return `<!-- wp:list${attrs} -->\n<${outerTag} class="wp-block-list">${node.innerHTML}</${outerTag}>\n<!-- /wp:list -->`;
+}
+
+function _convertQuote(node) {
+    let inner = node.innerHTML.trim();
+    if (!inner.startsWith('<')) {
+        inner = `<p>${inner}</p>`;
+    }
+    return `<!-- wp:quote -->\n<blockquote class="wp-block-quote">${inner}</blockquote>\n<!-- /wp:quote -->`;
+}
+
+function _convertCode(node) {
+    const inner = node.innerHTML.replace(/<code\s+class="[^"]*">/g, '<code>');
+    return `<!-- wp:code -->\n<pre class="wp-block-code">${inner}</pre>\n<!-- /wp:code -->`;
+}
+
+function _convertTable(node) {
+    return `<!-- wp:table -->\n<figure class="wp-block-table"><table>${node.innerHTML}</table></figure>\n<!-- /wp:table -->`;
+}
+
+function _convertImage(node) {
+    const img = node.tagName?.toLowerCase() === 'img' ? node : node.querySelector('img');
+    if (!img) return `<!-- wp:html -->\n${node.outerHTML}\n<!-- /wp:html -->`;
+    const src = img.getAttribute('src') || '';
+    const alt = img.getAttribute('alt') || '';
+    return `<!-- wp:image -->\n<figure class="wp-block-image"><img src="${src}" alt="${alt}"/></figure>\n<!-- /wp:image -->`;
+}
+
+function htmlToGutenbergBlocks(html) {
+    const root = parseHTML(html);
+    const blocks = [];
+    for (const node of root.childNodes) {
+        if (node.nodeType === 3) {
+            const text = node.text.trim();
+            if (!text) continue;
+            blocks.push(`<!-- wp:paragraph -->\n<p>${text}</p>\n<!-- /wp:paragraph -->`);
+            continue;
+        }
+        if (node.nodeType !== 1) continue;
+        const tag = node.tagName?.toLowerCase();
+        switch (tag) {
+            case 'h1': case 'h2': case 'h3': case 'h4': case 'h5': case 'h6':
+                blocks.push(_convertHeading(node));
+                break;
+            case 'p':
+                blocks.push(_convertParagraph(node));
+                break;
+            case 'ul': case 'ol':
+                blocks.push(_convertList(node));
+                break;
+            case 'blockquote':
+                blocks.push(_convertQuote(node));
+                break;
+            case 'pre':
+                blocks.push(_convertCode(node));
+                break;
+            case 'hr':
+                blocks.push(`<!-- wp:separator -->\n<hr class="wp-block-separator has-alpha-channel-opacity"/>\n<!-- /wp:separator -->`);
+                break;
+            case 'table':
+                blocks.push(_convertTable(node));
+                break;
+            case 'figure':
+            case 'img':
+                blocks.push(_convertImage(node));
+                break;
+            default:
+                blocks.push(`<!-- wp:html -->\n${node.outerHTML}\n<!-- /wp:html -->`);
+                break;
+        }
+    }
+    return blocks.join('\n\n');
+}
+
+async function resolveFileToBlockHTML(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const raw = readHTMLFromFile(filePath).html;
+    if (ext === '.md') {
+        const html = await marked.parse(raw);
+        return htmlToGutenbergBlocks(html);
+    } else if (ext === '.html' || ext === '.htm') {
+        return raw;
+    } else {
+        throw new Error(`対応していないファイル形式です: ${ext} (.md または .html のみ)`);
+    }
+}
+
 // ========================================
 // Media Utilities
 // ========================================
@@ -610,6 +722,16 @@ function generateSearchVariants(query, strip = [], prefixes = []) {
     return [...variants];
 }
 
+function flattenFileBirdFolders(folders, result = []) {
+    for (const f of folders) {
+        result.push({ id: f.id, name: f.text || f.title || f.name || '', count: parseInt(f['data-count'], 10) || 0 });
+        if (f.children && f.children.length > 0) {
+            flattenFileBirdFolders(f.children, result);
+        }
+    }
+    return result;
+}
+
 /**
  * 単一クライアントの Editor/Headless 判定
  * @returns {{ mode: 'editor'|'headless'|'error', postId?: number, message?: string, client?: FridayWPClient }}
@@ -2381,13 +2503,14 @@ const tools = [
     },
     {
         name: "list_blog_parts",
-        description: "List or search blog parts (reusable blocks). SWELL theme only.",
+        description: "List or search blog parts (reusable blocks). When partsId is specified, returns posts/pages that directly use that blog parts. SWELL theme only.",
         inputSchema: {
             type: "object",
             properties: {
                 site: siteParam,
-                search: { type: "string", description: "Keyword search" },
-                status: { type: "string", enum: ["publish", "draft", "private", "any"], description: "Status filter (default: publish)" },
+                partsId: { type: "integer", description: "Blog parts ID. When specified, returns posts/pages that directly use this blog parts instead of listing blog parts." },
+                search: { type: "string", description: "Keyword search (ignored when partsId is set)" },
+                status: { type: "string", enum: ["publish", "draft", "private", "any"], description: "Status filter (default: publish, ignored when partsId is set)" },
                 per_page: { type: "integer", description: "Per page (1-100)", minimum: 1, maximum: 100 },
                 page: { type: "integer", description: "Page number", minimum: 1 },
             },
@@ -2411,12 +2534,12 @@ const tools = [
     },
     {
         name: "create_blog_parts",
-        description: "Create a new blog parts (reusable block). SWELL theme only. Returns ID and editor URL.",
+        description: "Create a new blog parts (reusable block). SWELL theme only. Returns partsId and editor URL. To insert into an article, use insert_blog_parts with the returned partsId.",
         inputSchema: {
             type: "object",
             properties: {
                 title:     { type: "string", description: "Blog parts title" },
-                status:    { type: "string", enum: ["publish", "draft", "pending", "private"], description: "Status (default: draft)" },
+                status:    { type: "string", enum: ["publish", "draft", "pending", "private"], description: "Status (default: publish)" },
                 slug:      { type: "string", description: "URL slug" },
                 content:   { type: "string", description: "HTML content (exclusive with filePath)" },
                 filePath:  { type: "string", description: "Local file path (.md or .html, exclusive with content)" },
@@ -2456,6 +2579,23 @@ const tools = [
             required: ["partsId"],
         },
     },
+    {
+        name: "insert_blog_parts",
+        description: "Insert a blog parts block into an article. Builds the correct block HTML automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                partsId:   { type: "integer", description: "Blog parts ID (required)" },
+                postId:    postIdParam,
+                site:      siteParam,
+                snapshotId: { type: "string", description: "Snapshot ID (from get_article_structure or any write response). Required when using beforeRef/afterRef. Omit to append to end." },
+                expectedRevision: { type: "string", description: "Revision from snapshot. Rejects if structure changed." },
+                beforeRef: { type: "string", description: "Insert before this ref." },
+                afterRef:  { type: "string", description: "Insert after this ref." },
+            },
+            required: ["partsId"],
+        },
+    },
     {
         name: "list_taxonomies",
         description: "List categories or tags.",
@@ -2504,7 +2644,7 @@ const tools = [
     },
     {
         name: "get_block_html",
-        description: "Get block HTML. Use before newHTML to safely edit custom/theme blocks.",
+        description: "Get block HTML. Use before newHTML to safely edit custom/theme blocks. Blog parts (loos/blog-parts) are auto-expanded to show inner content. To edit blog parts content, use update_blog_parts.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2701,11 +2841,21 @@ const tools = [
             properties: {
                 site: siteParam,
                 query: { type: "string", description: "Search keyword" },
+                folder: { type: "string", description: "FileBird folder name (partial match). Filters media to this folder." },
                 strip: { type: "array", items: { type: "string" }, description: "Suffixes to strip (e.g. ['先生', 'さん'])" },
                 prefix: { type: "array", items: { type: "string" }, description: "Prefixes to add (e.g. ['エキサイト-'])" },
                 per_page: { type: "integer", description: "Results per variant (1-20, default: 10)", minimum: 1, maximum: 20 },
             },
-            required: ["query"],
+        },
+    },
+    {
+        name: "list_media_folders",
+        description: "List FileBird media folders. Returns folder names, IDs, and file counts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                site: siteParam,
+            },
         },
     },
     {
@@ -2767,6 +2917,7 @@ const tools = [
                 asp_url: { type: "string", description: "ASP affiliate URL (required)" },
                 asp_url_sp: { type: "string", description: "ASP URL (B) for A/B testing (optional)" },
                 direct_url: { type: "string", description: "Direct URL bypassing ASP (optional)" },
+                permalink: { type: "string", description: "WordPress permalink slug (defaults to asp_id, then slug if omitted)" },
             },
             required: ["title", "slug", "asp_url"],
         },
@@ -2898,7 +3049,7 @@ async function handleUpdateBlocksTool(args, toolName) {
             return { content: [{ type: "text", text: "❌ filePath は attributeUpdates と併用できません。" }], isError: true };
         }
         try {
-            newHTML = readHTMLFromFile(args.filePath).html;
+            newHTML = await resolveFileToBlockHTML(args.filePath);
         } catch (e) {
             return { content: [{ type: "text", text: `❌ ${e.message}` }], isError: true };
         }
@@ -3168,7 +3319,7 @@ async function handleUpdateBlocksTool(args, toolName) {
 }
 
 // ツール実行のハンドラ
-const _WRITE_TOOLS = new Set(['update_blocks', 'delete_block', 'move_block', 'duplicate_block', 'insert_block', 'table_operations', 'update_blog_parts']);
+const _WRITE_TOOLS = new Set(['update_blocks', 'delete_block', 'move_block', 'duplicate_block', 'insert_block', 'table_operations', 'update_blog_parts', 'insert_blog_parts']);
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     const _toolLogStart = Date.now();
@@ -4230,15 +4381,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
                 if (filePath) {
                     try {
-                        const ext = extname(filePath).toLowerCase();
-                        const raw = readHTMLFromFile(filePath).html;
-                        if (ext === '.md') {
-                            content = await marked.parse(raw);
-                        } else if (ext === '.html' || ext === '.htm') {
-                            content = raw;
-                        } else {
-                            return { content: [{ type: "text", text: `❌ 対応していないファイル形式です: ${ext} (.md または .html のみ)` }], isError: true };
-                        }
+                        content = await resolveFileToBlockHTML(filePath);
                     } catch (e) {
                         return { content: [{ type: "text", text: `❌ ${e.message}` }], isError: true };
                     }
@@ -4360,15 +4503,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
                 if (filePath) {
                     try {
-                        const ext = extname(filePath).toLowerCase();
-                        const raw = readHTMLFromFile(filePath).html;
-                        if (ext === '.md') {
-                            content = await marked.parse(raw);
-                        } else if (ext === '.html' || ext === '.htm') {
-                            content = raw;
-                        } else {
-                            return { content: [{ type: "text", text: `❌ 対応していないファイル形式です: ${ext} (.md または .html のみ)` }], isError: true };
-                        }
+                        content = await resolveFileToBlockHTML(filePath);
                     } catch (e) {
                         return { content: [{ type: "text", text: `❌ ${e.message}` }], isError: true };
                     }
@@ -4376,7 +4511,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
                 const postData = {
                     title,
-                    status: args?.status || 'draft',
+                    status: args?.status || 'publish',
                     post_type: 'blog_parts',
                 };
                 if (args?.slug !== undefined)      postData.slug = args.slug;
@@ -4410,6 +4545,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }
 
                 const bpResult = await client.searchBlogParts(args || {});
+
+                if (args?.partsId) {
+                    const usedBy = bpResult.usedBy || [];
+                    if (usedBy.length === 0) {
+                        return { content: [{ type: "text", text: `📋 ブログパーツ [${bpResult.partsId}] "${bpResult.partsTitle}" はどの記事でも使用されていません。` }] };
+                    }
+                    const usageList = usedBy.map(p =>
+                        `  [${p.postId}] ${p.title || '(無題)'}\n    ステータス: ${p.status} | 更新: ${p.modified || '-'}`
+                    ).join('\n\n');
+                    let usageText = `📋 ブログパーツ [${bpResult.partsId}] "${bpResult.partsTitle}" の直接使用箇所 (${usedBy.length}件 / 全${bpResult.total}件)\n\n${usageList}`;
+                    if (bpResult.total_pages > 1) {
+                        const pg = args?.page || 1;
+                        usageText += `\n\n📄 ページ: ${pg} / ${bpResult.total_pages}`;
+                        if (pg < bpResult.total_pages) usageText += ` (次: page=${pg + 1})`;
+                    }
+                    return { content: [{ type: "text", text: usageText }] };
+                }
+
                 const bpParts = bpResult.items || [];
                 const bpTotal = bpResult.total || 0;
                 const bpTotalPages = bpResult.total_pages || 0;
@@ -4423,7 +4576,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     return `  [${p.id}] ${p.title || '(無題)'}\n    ステータス: ${p.status} | 更新: ${p.modified || '-'}`;
                 }).join('\n\n');
 
-                let bpText = `📋 ブログ��ーツ一覧 (${bpParts.length}件 / 全${bpTotal}件)\n\n${bpList}`;
+                let bpText = `📋 ブログパーツ一覧 (${bpParts.length}件 / 全${bpTotal}件)\n\n${bpList}`;
                 if (bpTotalPages > 1) {
                     bpText += `\n\n📄 ページ: ${bpPage} / ${bpTotalPages}`;
                     if (bpPage < bpTotalPages) {
@@ -4629,6 +4782,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return { content: [{ type: "text", text }] };
             }
 
+            case "insert_blog_parts": {
+                if (!args?.partsId) {
+                    return { content: [{ type: "text", text: "❌ partsId は必須です。" }], isError: true };
+                }
+                args.rawHTML = `<!-- wp:loos/blog-parts {"partsID":"${args.partsId}"} /-->`;
+                // insert_block に fallthrough
+            }
+
             case "insert_block": {
                 let { rawHTML, filePath } = (args || {});
 
@@ -4644,7 +4805,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
                 // filePath → rawHTML 解決
                 if (filePath) {
-                    try { rawHTML = readHTMLFromFile(filePath).html; }
+                    try { rawHTML = await resolveFileToBlockHTML(filePath); }
                     catch (e) { return { content: [{ type: "text", text: `❌ ${e.message}` }], isError: true }; }
                 }
                 if (!rawHTML) {
@@ -4757,10 +4918,36 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     blocks = result.blocks || [];
                 }
 
+                // エディタモード時、ブログパーツの展開を補完
+                if (mode === 'editor' && client) {
+                    for (const b of blocks) {
+                        if (b.type === 'loos/blog-parts' && !b.blogParts) {
+                            const pid = parseInt(b.html?.match(/partsID["\s:]+["']?(\d+)/)?.[1], 10);
+                            if (pid > 0) {
+                                try {
+                                    const bpResult = await client.headlessGetBlockHtml(pid, {});
+                                    b.blogParts = {
+                                        partsId: pid,
+                                        blocks: bpResult?.blocks || [],
+                                    };
+                                } catch (_) {}
+                            }
+                        }
+                    }
+                }
+
                 const _modeTag = process.env.FRIDAY_DEBUG === '1' ? `\n[DEBUG] mode=${mode}` : '';
                 let text = `📦 ブロックHTML取得 (${blocks.length}件)\n`;
                 for (const b of blocks) {
-                    text += `\n[${b.index}] ${b.type}\n${b.html}\n`;
+                    text += `\n[${b.index}] ${b.type}\n`;
+                    if (b.blogParts && b.blogParts.blocks) {
+                        for (const inner of b.blogParts.blocks) {
+                            if ((inner.depth || 0) > 0) continue;
+                            text += `${inner.html}\n`;
+                        }
+                    } else {
+                        text += `${b.html}\n`;
+                    }
                 }
                 text += _modeTag;
                 return { content: [{ type: "text", text }] };
@@ -5126,50 +5313,126 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 try { client = registry.get(siteName); }
                 catch (e) { return errorResponse("search_media", e.message, siteName); }
 
-                if (!args?.query) return errorResponse("search_media", "query is required", siteName);
+                if (!args?.query && !args?.folder) return errorResponse("search_media", "query または folder のどちらかは必須です", siteName);
 
-                const variants = generateSearchVariants(args.query, args?.strip, args?.prefix);
                 const perPage = args?.per_page || 10;
 
-                const results = await Promise.allSettled(
-                    variants.map(v => client.searchMedia(v, perPage))
-                );
-
-                const seenIds = new Set();
-                const hits = [];
-                for (let i = 0; i < results.length; i++) {
-                    if (results[i].status !== 'fulfilled') continue;
-                    for (const item of results[i].value) {
-                        if (seenIds.has(item.id)) continue;
-                        seenIds.add(item.id);
-                        hits.push({
-                            id: item.id,
-                            title: item.title?.rendered || '',
-                            alt: item.alt_text || '',
-                            url: item.source_url || '',
-                            width: item.media_details?.width || null,
-                            height: item.media_details?.height || null,
-                            matched: variants[i],
-                        });
+                // --- FileBird folder filtering ---
+                let folderIncludeIds = null;
+                let folderInfo = '';
+                if (args?.folder) {
+                    if (!client.filebirdToken) {
+                        return errorResponse("search_media", "FileBird APIキーが未設定です。connections.json に filebirdToken を追加してください", siteName);
+                    }
+                    const folders = await client.getFileBirdFolders();
+                    if (!folders) {
+                        return errorResponse("search_media", "FileBird API へのアクセスに失敗しました", siteName);
                     }
+                    const flat = flattenFileBirdFolders(folders);
+                    const matched = flat.filter(f => f.name.includes(args.folder));
+                    if (matched.length === 0) {
+                        return errorResponse("search_media", `フォルダ "${args.folder}" が見つかりません。\n利用可能: ${flat.map(f => f.name).join(', ')}`, siteName);
+                    }
+                    if (matched.length > 1) {
+                        let text = `📁 "${args.folder}" に複数のフォルダがマッチしました。絞り込んでください:\n\n`;
+                        for (const f of matched) {
+                            text += `  [ID: ${f.id}] ${f.name} (${f.count}件)\n`;
+                        }
+                        return { content: [{ type: "text", text }] };
+                    }
+                    const folder = matched[0];
+                    const attachmentIds = await client.getFileBirdAttachmentIds(folder.id);
+                    if (!attachmentIds || attachmentIds.length === 0) {
+                        return { content: [{ type: "text", text: `📁 ${folder.name} (0件)\n\n❌ フォルダ内にメディアがありません。` }] };
+                    }
+                    folderIncludeIds = attachmentIds;
+                    const totalCount = attachmentIds.length;
+                    const limited = totalCount > 100;
+                    folderInfo = `📁 Folder: ${folder.name} (${totalCount}件${limited ? '、先頭100件から検索' : ''})\n`;
                 }
 
-                let text = `🔍 Search: "${args.query}"\n`;
-                text += `🔄 Variants (${variants.length}): ${variants.join(', ')}\n\n`;
+                // --- keyword search (with or without folder filter) ---
+                if (args?.query) {
+                    const variants = generateSearchVariants(args.query, args?.strip, args?.prefix);
+                    const results = await Promise.allSettled(
+                        variants.map(v => client.searchMedia(v, perPage, folderIncludeIds))
+                    );
+
+                    const seenIds = new Set();
+                    const hits = [];
+                    for (let i = 0; i < results.length; i++) {
+                        if (results[i].status !== 'fulfilled') continue;
+                        for (const item of results[i].value) {
+                            if (seenIds.has(item.id)) continue;
+                            seenIds.add(item.id);
+                            hits.push({
+                                id: item.id,
+                                title: item.title?.rendered || '',
+                                alt: item.alt_text || '',
+                                url: item.source_url || '',
+                                width: item.media_details?.width || null,
+                                height: item.media_details?.height || null,
+                                matched: variants[i],
+                            });
+                        }
+                    }
 
-                if (hits.length === 0) {
+                    let text = folderInfo;
+                    text += `🔍 Search: "${args.query}"\n`;
+                    text += `🔄 Variants (${variants.length}): ${variants.join(', ')}\n\n`;
+
+                    if (hits.length === 0) {
+                        text += '❌ No results found.';
+                    } else {
+                        text += `📷 ${hits.length} result(s):\n\n`;
+                        for (const h of hits) {
+                            text += `  [ID: ${h.id}] ${h.title}\n`;
+                            text += `    Alt: ${h.alt}\n`;
+                            text += `    URL: ${h.url}\n`;
+                            if (h.width && h.height) text += `    Size: ${h.width}x${h.height}\n`;
+                            text += `    Matched: "${h.matched}"\n\n`;
+                        }
+                    }
+                    return { content: [{ type: "text", text }] };
+                }
+
+                // --- folder only (no query) ---
+                const mediaItems = await client.searchMedia(null, perPage, folderIncludeIds);
+                let text = folderInfo + '\n';
+                if (!mediaItems || mediaItems.length === 0) {
                     text += '❌ No results found.';
                 } else {
-                    text += `📷 ${hits.length} result(s):\n\n`;
-                    for (const h of hits) {
-                        text += `  [ID: ${h.id}] ${h.title}\n`;
-                        text += `    Alt: ${h.alt}\n`;
-                        text += `    URL: ${h.url}\n`;
-                        if (h.width && h.height) text += `    Size: ${h.width}x${h.height}\n`;
-                        text += `    Matched: "${h.matched}"\n\n`;
+                    text += `📷 ${mediaItems.length} result(s):\n\n`;
+                    for (const item of mediaItems) {
+                        text += `  [ID: ${item.id}] ${item.title?.rendered || ''}\n`;
+                        text += `    Alt: ${item.alt_text || ''}\n`;
+                        text += `    URL: ${item.source_url || ''}\n`;
+                        const w = item.media_details?.width, h = item.media_details?.height;
+                        if (w && h) text += `    Size: ${w}x${h}\n`;
+                        text += '\n';
                     }
                 }
+                return { content: [{ type: "text", text }] };
+            }
 
+            case "list_media_folders": {
+                const siteName = args?.site || 'default';
+                let client;
+                try { client = registry.get(siteName); }
+                catch (e) { return errorResponse("list_media_folders", e.message, siteName); }
+
+                if (!client.filebirdToken) {
+                    return { content: [{ type: "text", text: "⚠️ FileBird 未導入または APIキーが未設定です。\nconnections.json に filebirdToken を追加してください。" }] };
+                }
+                const folders = await client.getFileBirdFolders();
+                if (!folders) {
+                    return errorResponse("list_media_folders", "FileBird API へのアクセスに失敗しました", siteName);
+                }
+                const flat = flattenFileBirdFolders(folders);
+                let text = `📁 FileBird フォルダ一覧 (${flat.length}件)\n\n`;
+                for (const f of flat) {
+                    text += `  [ID: ${f.id}] ${f.name} (${f.count}件)\n`;
+                }
                 return { content: [{ type: "text", text }] };
             }
 
@@ -5248,7 +5511,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const list = items.map(item => {
                     const lines = [
                         `  [${item.id}] ${item.title}`,
-                        `    案件ID: ${item.data_id} | slug: ${item.slug}`,
+                        `    案件ID: ${item.data_id} | slug: ${item.slug} | permalink: ${item.permalink}`,
                     ];
                     if (item.asp_url) lines.push(`    ASP URL: ${item.asp_url}`);
                     if (item.asp_url_sp) lines.push(`    ASP URL(B): ${item.asp_url_sp}`);
@@ -5287,6 +5550,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         asp_url: args.asp_url,
                         asp_url_sp: args?.asp_url_sp,
                         direct_url: args?.direct_url,
+                        permalink: args?.permalink,
                     });
                 } catch (e) {
                     return { content: [{ type: "text", text: `❌ ASPリンク登録エラー: ${e.message}` }], isError: true };
@@ -5298,6 +5562,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     `  ID: ${result.id}`,
                     `  タイトル: ${result.title}`,
                     `  slug: ${result.slug}`,
+                    `  permalink: ${result.permalink}`,
                     `  案件ID: ${result.data_id}`,
                 ];
                 if (result.asp_url) lines.push(`  ASP URL: ${result.asp_url}`);

package/dist/wordpress-api.js

@@ -279,9 +279,13 @@ export class FridayWPClient {
 
     async searchBlogParts(params = {}) {
         const query = new URLSearchParams();
-        if (params.search) query.set('search', params.search);
-        if (params.slug) query.set('slug', params.slug);
-        if (params.status) query.set('status', params.status);
+        if (params.partsId) {
+            query.set('parts_id', String(params.partsId));
+        } else {
+            if (params.search) query.set('search', params.search);
+            if (params.slug) query.set('slug', params.slug);
+            if (params.status) query.set('status', params.status);
+        }
         if (params.per_page) query.set('per_page', String(Math.min(Math.max(1, params.per_page), 100)));
         if (params.page) query.set('page', String(Math.max(1, params.page)));
         const qs = query.toString();
@@ -457,15 +461,36 @@ export class FridayWPClient {
      * @param {number} perPage 取得件数（デフォルト10）
      * @returns {object[]} メディアオブジェクト配列
      */
-    async searchMedia(query, perPage = 10) {
+    async searchMedia(query, perPage = 10, includeIds = null) {
         const params = new URLSearchParams({
-            search: query,
             media_type: 'image',
             per_page: String(Math.min(Math.max(1, perPage), 20)),
         });
+        if (query) params.set('search', query);
+        if (includeIds && includeIds.length > 0) {
+            params.set('include', includeIds.slice(0, 100).join(','));
+        }
         return this.wpCoreRequest(`/wp/v2/media?${params.toString()}`);
     }
 
+    async getFileBirdFolders() {
+        if (!this.filebirdToken) return null;
+        const url = `${this.wpUrl}/wp-json/filebird/public/v1/folders?token=${this.filebirdToken}`;
+        const res = await fetch(url);
+        if (!res.ok) return null;
+        const json = await res.json();
+        return json.success ? json.data.folders : null;
+    }
+
+    async getFileBirdAttachmentIds(folderId) {
+        if (!this.filebirdToken) return null;
+        const url = `${this.wpUrl}/wp-json/filebird/public/v1/attachment-id/?folder_id=${folderId}&token=${this.filebirdToken}`;
+        const res = await fetch(url);
+        if (!res.ok) return null;
+        const json = await res.json();
+        return json.success ? json.data.attachment_ids : null;
+    }
+
     // ========================================
     // ASP Link Management
     // ========================================
@@ -504,6 +529,7 @@ export class FridayWPClient {
         instance.wpAppPassword = config.pass;
         instance.authHeader = "Basic " + Buffer.from(`${config.user}:${config.pass}`).toString("base64");
         instance.baseUrl = config.url.replace(/\/$/, '') + '/wp-json/friday/v1';
+        instance.filebirdToken = config.filebirdToken || config.filebird_token || null;
         instance.bridgeClient = null;
         return instance;
     }
@@ -587,7 +613,7 @@ export class ConnectionRegistry {
     /** FRIDAY_CONN_{name}_{URL|USER|PASS} をパースして { name: { url, user, pass } } を返す */
     _parseConnEnvVars() {
         const conns = {};
-        const pattern = /^FRIDAY_CONN_(.+?)_(URL|USER|PASS)$/;
+        const pattern = /^FRIDAY_CONN_(.+?)_(URL|USER|PASS|FILEBIRD_TOKEN)$/;
         for (const [key, value] of Object.entries(process.env)) {
             const m = key.match(pattern);
             if (!m) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "friday-mcp-v2",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "WordPress MCP Server for Claude Code - REST API direct communication",
   "type": "module",
   "main": "dist/mcp-server.js",
@@ -23,8 +23,9 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "node-fetch": "^3.3.2",
     "marked": "^15.0.0",
+    "node-fetch": "^3.3.2",
+    "node-html-parser": "^7.1.0",
     "ws": "^8.19.0"
   }
 }