note-connector 0.2.5 → 0.2.6

package/py/src/note_mcp/server.py

@@ -0,0 +1,905 @@
+"""FastMCP server for note.com article management.
+
+Provides MCP tools for creating, updating, and managing note.com articles.
+Supports investigator mode for API investigation via INVESTIGATOR_MODE=1.
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Annotated
+
+from fastmcp import FastMCP
+
+from note_mcp.api.articles import (
+    create_draft,
+    delete_all_drafts,
+    delete_article,
+    delete_draft,
+    get_article,
+    list_articles,
+    publish_article,
+    unpublish_article,
+    update_article,
+)
+from note_mcp.api.images import insert_image_via_api, upload_body_image, upload_eyecatch_image
+from note_mcp.api.preview import get_preview_html
+from note_mcp.auth.browser import login_with_browser
+from note_mcp.auth.session import SessionManager
+from note_mcp.browser.preview import show_preview
+from note_mcp.decorators import handle_api_error, require_session
+from note_mcp.investigator import register_investigator_tools
+from note_mcp.models import ArticleInput, ArticleStatus, NoteAPIError, Session
+from note_mcp.utils.file_parser import parse_markdown_file
+
+# Create MCP server instance
+mcp = FastMCP("note-mcp")
+
+
+# Session manager instance
+_session_manager = SessionManager()
+
+
+@mcp.tool()
+async def note_login(
+    timeout: Annotated[int, "ログインのタイムアウト時間（秒）。デフォルトは300秒。"] = 300,
+) -> str:
+    """note.comにログインします。
+
+    ブラウザウィンドウが開き、手動でログインを行います。
+    ログイン完了後、セッション情報が安全に保存されます。
+
+    Args:
+        timeout: ログインのタイムアウト時間（秒）
+
+    Returns:
+        ログイン結果のメッセージ
+    """
+    session = await login_with_browser(timeout=timeout)
+    return f"ログインに成功しました。ユーザー名: {session.username}"
+
+
+@mcp.tool()
+async def note_check_auth() -> str:
+    """現在の認証状態を確認します。
+
+    保存されているセッション情報を確認し、有効かどうかを返します。
+
+    Returns:
+        認証状態のメッセージ
+    """
+    if not _session_manager.has_session():
+        return "未認証です。note_loginを使用してログインしてください。"
+
+    session = _session_manager.load()
+    if session is None:
+        return "セッションの読み込みに失敗しました。note_loginで再ログインしてください。"
+
+    if session.is_expired():
+        return "セッションの有効期限が切れています。note_loginで再ログインしてください。"
+
+    return f"認証済みです。ユーザー名: {session.username}"
+
+
+@mcp.tool()
+async def note_logout() -> str:
+    """note.comからログアウトします。
+
+    保存されているセッション情報を削除します。
+
+    Returns:
+        ログアウト結果のメッセージ
+    """
+    _session_manager.clear()
+    return "ログアウトしました。"
+
+
+@mcp.tool()
+async def note_set_username(
+    username: Annotated[str, "note.comのユーザー名（URLに表示される名前、例: your_username）"],
+) -> str:
+    """ユーザー名を手動で設定します。
+
+    ログイン時にユーザー名の自動取得に失敗した場合に使用します。
+    ユーザー名はnote.comのプロフィールURLから確認できます。
+    例: https://note.com/your_username → your_username
+
+    Args:
+        username: note.comのユーザー名
+
+    Returns:
+        設定結果のメッセージ
+    """
+    from note_mcp.models import Session
+
+    if not _session_manager.has_session():
+        return "セッションが存在しません。先にnote_loginを実行してください。"
+
+    session = _session_manager.load()
+    if session is None:
+        return "セッションの読み込みに失敗しました。note_loginで再ログインしてください。"
+
+    # Validate username format
+    import re
+
+    if not re.match(r"^[a-zA-Z0-9_-]+$", username):
+        return "無効なユーザー名です。英数字、アンダースコア、ハイフンのみ使用できます。"
+
+    # Create updated session with new username
+    updated_session = Session(
+        cookies=session.cookies,
+        user_id=username,  # Use username as user_id
+        username=username,
+        expires_at=session.expires_at,
+        created_at=session.created_at,
+    )
+
+    _session_manager.save(updated_session)
+    return f"ユーザー名を '{username}' に設定しました。"
+
+
+@mcp.tool()
+async def note_create_draft(
+    title: Annotated[str, "記事のタイトル"],
+    body: Annotated[str, "記事の本文（Markdown形式）"],
+    tags: Annotated[list[str] | None, "記事のタグ（#なしでも可）"] = None,
+) -> str:
+    """note.comに下書き記事を作成します。
+
+    Markdown形式の本文をHTMLに変換してnote.comに送信します。
+    blockquote内の引用（— 出典名）はfigcaptionに自動入力されます。
+
+    Args:
+        title: 記事のタイトル
+        body: 記事の本文（Markdown形式）
+        tags: 記事のタグ（オプション）
+
+    Returns:
+        作成結果のメッセージ（記事IDを含む）
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    article_input = ArticleInput(
+        title=title,
+        body=body,
+        tags=tags or [],
+    )
+
+    try:
+        article = await create_draft(session, article_input)
+    except NoteAPIError as e:
+        return f"記事作成に失敗しました: {e}"
+
+    tag_info = f"、タグ: {', '.join(article.tags)}" if article.tags else ""
+    return f"下書きを作成しました。ID: {article.id}、キー: {article.key}{tag_info}"
+
+
+@mcp.tool()
+async def note_get_article(
+    article_id: Annotated[str, "取得する記事のID"],
+) -> str:
+    """記事の内容を取得します。
+
+    指定したIDの記事のタイトル、本文、ステータスを取得します。
+    記事を編集する前に既存内容を確認する際に使用します。
+
+    推奨ワークフロー:
+    1. note_get_article で既存内容を取得
+    2. 取得した内容を元に編集を決定
+    3. note_update_article で更新を保存
+
+    Args:
+        article_id: 取得する記事のID
+
+    Returns:
+        記事の内容（タイトル、本文、ステータス）
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    try:
+        article = await get_article(session, article_id)
+    except NoteAPIError as e:
+        return f"記事の取得に失敗しました: {e}"
+
+    tag_info = f"\nタグ: {', '.join(article.tags)}" if article.tags else ""
+
+    return f"""記事を取得しました。
+
+タイトル: {article.title}
+ステータス: {article.status.value}{tag_info}
+
+本文:
+{article.body}"""
+
+
+@mcp.tool()
+async def note_update_article(
+    article_id: Annotated[str, "更新する記事のID"],
+    title: Annotated[str, "新しいタイトル"],
+    body: Annotated[str, "新しい本文（Markdown形式）"],
+    tags: Annotated[list[str] | None, "新しいタグ（#なしでも可）"] = None,
+) -> str:
+    """既存の記事を更新します。
+
+    編集前にnote_get_articleで既存内容を取得することを推奨します。
+    Markdown形式の本文をHTMLに変換してnote.comに送信します。
+
+    Args:
+        article_id: 更新する記事のID
+        title: 新しいタイトル
+        body: 新しい本文（Markdown形式）
+        tags: 新しいタグ（オプション）
+
+    Returns:
+        更新結果のメッセージ
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    article_input = ArticleInput(
+        title=title,
+        body=body,
+        tags=tags or [],
+    )
+
+    try:
+        article = await update_article(session, article_id, article_input)
+    except NoteAPIError as e:
+        return f"記事更新に失敗しました: {e}"
+
+    tag_info = f"、タグ: {', '.join(article.tags)}" if article.tags else ""
+    return f"記事を更新しました。ID: {article.id}{tag_info}"
+
+
+@mcp.tool()
+@require_session
+@handle_api_error
+async def note_upload_eyecatch(
+    session: Session,
+    file_path: Annotated[str, "アップロードする画像ファイルのパス"],
+    note_id: Annotated[str, "画像を関連付ける記事のID（数字のみ）"],
+) -> str:
+    """記事のアイキャッチ（見出し）画像をアップロードします。
+
+    JPEG、PNG、GIF、WebP形式の画像をアップロードできます。
+    最大ファイルサイズは10MBです。
+    アップロードした画像は記事の見出し画像として設定されます。
+
+    note_list_articlesで記事一覧を取得し、IDを確認できます。
+
+    Args:
+        file_path: アップロードする画像ファイルのパス
+        note_id: 画像を関連付ける記事のID
+
+    Returns:
+        アップロード結果（画像URLを含む）
+    """
+    image = await upload_eyecatch_image(session, file_path, note_id=note_id)
+    return f"アイキャッチ画像をアップロードしました。URL: {image.url}"
+
+
+@mcp.tool()
+@require_session
+@handle_api_error
+async def note_upload_body_image(
+    session: Session,
+    file_path: Annotated[str, "アップロードする画像ファイルのパス"],
+    note_id: Annotated[str, "画像を関連付ける記事のID（数字のみ）"],
+) -> str:
+    """記事本文内に埋め込む画像をアップロードします。
+
+    JPEG、PNG、GIF、WebP形式の画像をアップロードできます。
+    最大ファイルサイズは10MBです。
+
+    **重要**: このツールは画像をアップロードしてURLを返すだけです。
+    画像を記事に直接挿入するには note_insert_body_image を使用してください。
+
+    note_list_articlesで記事一覧を取得し、IDを確認できます。
+
+    Args:
+        file_path: アップロードする画像ファイルのパス
+        note_id: 画像を関連付ける記事のID
+
+    Returns:
+        アップロード結果（画像URLを含む）
+    """
+    image = await upload_body_image(session, file_path, note_id=note_id)
+    return (
+        f"本文用画像をアップロードしました。URL: {image.url}\n\n"
+        f"※画像を記事に直接挿入するには note_insert_body_image を使用してください。"
+    )
+
+
+@mcp.tool()
+async def note_insert_body_image(
+    file_path: Annotated[str, "挿入する画像ファイルのパス"],
+    article_id: Annotated[str, "画像を挿入する記事のID（数値またはキー形式）"],
+    caption: Annotated[str | None, "画像のキャプション（オプション）"] = None,
+) -> str:
+    """記事本文内に画像を直接挿入します。
+
+    API経由で画像をアップロードし、ProseMirrorで直接挿入します。
+    JPEG、PNG、GIF、WebP形式の画像を挿入できます。
+    最大ファイルサイズは10MBです。
+
+    note_list_articlesで記事一覧を取得し、IDを確認できます。
+
+    Args:
+        file_path: 挿入する画像ファイルのパス
+        article_id: 画像を挿入する記事のID（数値またはキー形式）
+        caption: 画像のキャプション（オプション）
+
+    Returns:
+        挿入結果のメッセージ
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    try:
+        result = await insert_image_via_api(
+            session=session,
+            article_id=article_id,
+            file_path=file_path,
+            caption=caption,
+        )
+
+        # insert_image_via_api always returns {"success": True} on success
+        # or raises NoteAPIError on failure, so we can assume success here
+        caption_info = f"、キャプション: {result['caption']}" if result.get("caption") else ""
+        fallback_info = "（フォールバック使用）" if result.get("fallback_used") else ""
+        return (
+            f"画像を挿入しました。{fallback_info}\n"
+            f"記事ID: {result['article_id']}、キー: {result['article_key']}{caption_info}\n"
+            f"画像URL: {result['image_url']}"
+        )
+    except NoteAPIError as e:
+        return f"エラー: {e}"
+
+
+@mcp.tool()
+@require_session
+@handle_api_error
+async def note_show_preview(
+    session: Session,
+    article_key: Annotated[str, "プレビューする記事のキー（例: n1234567890ab）"],
+) -> str:
+    """記事のプレビューをブラウザで表示します。
+
+    指定した記事のプレビューページをブラウザで開きます。
+    API経由でプレビューアクセストークンを取得し、直接プレビューURLにアクセスします。
+    エディターページを経由しないため、高速かつ安定しています。
+
+    Args:
+        article_key: プレビューする記事のキー
+
+    Returns:
+        プレビュー結果のメッセージ
+    """
+    await show_preview(session, article_key)
+    return f"プレビューを表示しました。記事キー: {article_key}"
+
+
+@mcp.tool()
+@require_session
+@handle_api_error
+async def note_get_preview_html(
+    session: Session,
+    article_key: Annotated[str, "取得する記事のキー（例: n1234567890ab）"],
+) -> str:
+    """プレビューページのHTMLを取得します。
+
+    指定した記事のプレビューページのHTMLを文字列として取得します。
+    E2Eテストやコンテンツ検証のために使用します。
+    ブラウザを起動せず、API経由で高速に取得します。
+
+    Args:
+        article_key: 取得する記事のキー
+
+    Returns:
+        プレビューページのHTML
+    """
+    return await get_preview_html(session, article_key)
+
+
+@mcp.tool()
+async def note_publish_article(
+    article_id: Annotated[str | None, "公開する下書き記事のID（新規作成時は省略）"] = None,
+    file_path: Annotated[str | None, "タグを取得するMarkdownファイルのパス"] = None,
+    title: Annotated[str | None, "記事タイトル（新規作成時は必須）"] = None,
+    body: Annotated[str | None, "記事本文（Markdown形式、新規作成時は必須）"] = None,
+    tags: Annotated[list[str] | None, "記事のタグ（#なしでも可）"] = None,
+) -> str:
+    """記事を公開します。
+
+    既存の下書きを公開するか、新規記事を作成して即公開できます。
+    article_idを指定すると既存の下書きを公開します。
+    title/bodyを指定すると新規記事を作成して公開します。
+
+    既存の下書きを公開する際、tagsが未指定でfile_pathが指定されている場合、
+    Markdownファイルのフロントマターからタグを取得します。
+
+    Args:
+        article_id: 公開する下書き記事のID（新規作成時は省略）
+        file_path: タグを取得するMarkdownファイルのパス（既存下書き公開時のみ有効）
+        title: 記事タイトル（新規作成時は必須）
+        body: 記事本文（Markdown形式、新規作成時は必須）
+        tags: 記事のタグ（オプション、file_pathより優先）
+
+    Returns:
+        公開結果のメッセージ（記事URLを含む）
+    """
+    from pathlib import Path
+
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    # Determine whether to publish existing or create new
+    try:
+        if article_id is not None:
+            # Publish existing draft
+            publish_tags = tags
+
+            # Issue #258: If tags not specified but file_path is, get tags from file
+            if publish_tags is None and file_path is not None:
+                try:
+                    parsed = parse_markdown_file(Path(file_path))
+                    publish_tags = parsed.tags if parsed.tags else []
+                except FileNotFoundError:
+                    return f"ファイルが見つかりません: {file_path}"
+                except ValueError as e:
+                    return f"ファイル解析エラー: {e}"
+
+            article = await publish_article(session, article_id=article_id, tags=publish_tags)
+        elif title is not None and body is not None:
+            # Create and publish new article (file_path is ignored for new articles)
+            article_input = ArticleInput(
+                title=title,
+                body=body,
+                tags=tags or [],
+            )
+            article = await publish_article(session, article_input=article_input)
+        else:
+            return "article_idまたは（titleとbody）のいずれかを指定してください。"
+    except NoteAPIError as e:
+        return f"記事公開に失敗しました: {e}"
+
+    url_info = f"、URL: {article.url}" if article.url else ""
+    return f"記事を公開しました。ID: {article.id}{url_info}"
+
+
+@mcp.tool()
+async def note_list_articles(
+    status: Annotated[str | None, "フィルタするステータス（draft/published/all）"] = None,
+    page: Annotated[int, "ページ番号（1から開始）"] = 1,
+    limit: Annotated[int, "1ページあたりの記事数（最大10）"] = 10,
+) -> str:
+    """自分の記事一覧を取得します。
+
+    ステータスでフィルタリングできます。
+
+    Args:
+        status: フィルタするステータス（draft/published/all、省略時はall）
+        page: ページ番号（1から開始）
+        limit: 1ページあたりの記事数（最大10）
+
+    Returns:
+        記事一覧の情報
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    # Convert status string to ArticleStatus enum
+    status_filter: ArticleStatus | None = None
+    if status is not None and status != "all":
+        try:
+            status_filter = ArticleStatus(status)
+        except ValueError:
+            return f"無効なステータスです: {status}。draft/published/allのいずれかを指定してください。"
+
+    try:
+        result = await list_articles(session, status=status_filter, page=page, limit=limit)
+    except NoteAPIError as e:
+        return f"記事一覧の取得に失敗しました: {e}"
+
+    if not result.articles:
+        return "記事が見つかりませんでした。"
+
+    # Format article list
+    lines = [f"記事一覧（{result.total}件中{len(result.articles)}件、ページ{result.page}）:"]
+    for article in result.articles:
+        status_label = "下書き" if article.status == ArticleStatus.DRAFT else "公開済み"
+        lines.append(f"  - [{status_label}] {article.title} (ID: {article.id}、キー: {article.key})")
+
+    if result.has_more:
+        lines.append(f"  （続きはpage={result.page + 1}で取得できます）")
+
+    return "\n".join(lines)
+
+
+@mcp.tool()
+async def note_create_from_file(
+    file_path: Annotated[str, "Markdownファイルのパス"],
+    upload_images: Annotated[bool, "ローカル画像をアップロードするかどうか"] = True,
+) -> str:
+    """Markdownファイルから下書き記事を作成します。
+
+    ファイルからタイトル、本文、タグ、ローカル画像、アイキャッチ画像を抽出し、
+    note.comに下書きを作成します。
+
+    YAMLフロントマターがある場合:
+    - titleフィールドからタイトルを取得
+    - tagsフィールドからタグを取得
+    - eyecatchフィールドからアイキャッチ画像パスを取得
+
+    フロントマターがない場合:
+    - 最初のH1見出しをタイトルとして使用（本文から削除）
+    - H1がなければH2を使用
+
+    ローカル画像（./images/example.pngなど）は自動的にアップロードされ、
+    本文内のパスがnote.comのURLに置換されます。
+
+    アイキャッチ画像が指定されている場合、自動的にアップロードされ、
+    記事のアイキャッチとして設定されます。
+
+    Args:
+        file_path: Markdownファイルのパス
+        upload_images: ローカル画像をアップロードするかどうか（デフォルト: True）
+            Falseの場合、ローカルパスがそのまま残り、プレビューで画像が表示されません。
+
+    Returns:
+        作成結果のメッセージ（記事IDを含む）
+    """
+    session = _session_manager.load()
+    if session is None:
+        return "ログインが必要です。note_loginを実行してください。"
+
+    from pathlib import Path
+
+    try:
+        parsed = parse_markdown_file(Path(file_path))
+    except FileNotFoundError:
+        return f"ファイルが見つかりません: {file_path}"
+    except ValueError as e:
+        return f"ファイル解析エラー: {e}"
+
+    article_input = ArticleInput(
+        title=parsed.title,
+        body=parsed.body,
+        tags=parsed.tags,
+    )
+
+    try:
+        article = await create_draft(session, article_input)
+
+        uploaded_count = 0
+        failed_images: list[str] = []
+
+        # Upload images via API and replace local paths with URLs
+        updated_body = parsed.body
+        if upload_images and parsed.local_images:
+            for img in parsed.local_images:
+                if img.absolute_path.exists():
+                    try:
+                        upload_result = await upload_body_image(
+                            session,
+                            str(img.absolute_path),
+                            article.id,
+                        )
+                        updated_body = updated_body.replace(
+                            f"({img.markdown_path})",
+                            f"({upload_result.url})",
+                        )
+                        uploaded_count += 1
+                    except NoteAPIError as e:
+                        failed_images.append(f"{img.markdown_path}: {e}")
+                else:
+                    failed_images.append(f"{img.markdown_path}: ファイルが見つかりません")
+
+        # Update article with image URLs
+        if uploaded_count > 0:
+            updated_input = ArticleInput(
+                title=parsed.title,
+                body=updated_body,
+                tags=parsed.tags,
+            )
+            await update_article(session, article.key, updated_input)
+
+        # Upload eyecatch image if specified
+        eyecatch_uploaded = False
+        eyecatch_error: str | None = None
+        if upload_images and parsed.eyecatch:
+            if parsed.eyecatch.exists():
+                try:
+                    await upload_eyecatch_image(
+                        session,
+                        str(parsed.eyecatch),
+                        article.id,
+                    )
+                    eyecatch_uploaded = True
+                except NoteAPIError as e:
+                    eyecatch_error = f"{parsed.eyecatch.name}: {e}"
+            else:
+                eyecatch_error = f"ファイルが見つかりません: {parsed.eyecatch}"
+
+        result_lines = [
+            "✅ 下書きを作成しました",
+            f"   タイトル: {article.title}",
+            f"   記事ID: {article.id}",
+            f"   記事キー: {article.key}",
+        ]
+
+        if uploaded_count > 0:
+            result_lines.append(f"   アップロードした画像: {uploaded_count}件")
+
+        if eyecatch_uploaded:
+            result_lines.append("   アイキャッチ画像: アップロード完了")
+
+        if failed_images:
+            result_lines.append(f"   ⚠️ 画像アップロード失敗: {len(failed_images)}件")
+            for msg in failed_images:
+                result_lines.append(f"      - {msg}")
+
+        if eyecatch_error:
+            result_lines.append(f"   ⚠️ アイキャッチ画像アップロード失敗: {eyecatch_error}")
+
+        return "\n".join(result_lines)
+
+    except NoteAPIError as e:
+        return f"記事作成エラー: {e}"
+
+
+@mcp.tool()
+async def note_delete_draft(
+    article_key: Annotated[str, "削除する記事のキー（例: n1234567890ab）"],
+    confirm: Annotated[bool, "削除を実行する場合はTrue、確認のみの場合はFalse"] = False,
+) -> str:
+    """下書き記事を削除します。
+
+    指定した下書き記事を削除します。公開済み記事は削除できません。
+
+    2段階確認フロー:
+    1. confirm=False: 削除対象の記事情報を表示（実際の削除は行わない）
+    2. confirm=True: 実際に削除を実行
+
+    **注意**: 削除は取り消しできません。
+
+    Args:
+        article_key: 削除する記事のキー
+        confirm: 削除を実行する場合はTrue（デフォルトはFalse）
+
+    Returns:
+        削除結果または確認メッセージ
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    try:
+        result = await delete_draft(session, article_key, confirm=confirm)
+
+        # Check result type and format response
+        from note_mcp.models import DeletePreview, DeleteResult
+
+        if isinstance(result, DeletePreview):
+            return (
+                f"削除対象の記事:\n"
+                f"  タイトル: {result.article_title}\n"
+                f"  キー: {result.article_key}\n"
+                f"  ステータス: {result.status.value}\n\n"
+                f"{result.message}"
+            )
+        elif isinstance(result, DeleteResult):
+            return result.message
+
+        return str(result)
+
+    except NoteAPIError as e:
+        return f"削除に失敗しました: {e.message}"
+
+
+@mcp.tool()
+async def note_delete_all_drafts(
+    confirm: Annotated[bool, "削除を実行する場合はTrue、確認のみの場合はFalse"] = False,
+) -> str:
+    """すべての下書き記事を一括削除します。
+
+    認証ユーザーのすべての下書き記事を削除します。
+    公開済み記事は削除されません。
+
+    2段階確認フロー:
+    1. confirm=False: 削除対象の記事一覧を表示（実際の削除は行わない）
+    2. confirm=True: 実際に削除を実行
+
+    **注意**: 削除は取り消しできません。
+
+    Args:
+        confirm: 削除を実行する場合はTrue（デフォルトはFalse）
+
+    Returns:
+        削除結果または確認メッセージ
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    try:
+        result = await delete_all_drafts(session, confirm=confirm)
+
+        # Check result type and format response
+        from note_mcp.models import BulkDeletePreview, BulkDeleteResult
+
+        if isinstance(result, BulkDeletePreview):
+            if result.total_count == 0:
+                return result.message
+
+            lines = [f"削除対象の下書き記事（{result.total_count}件）:"]
+            for article in result.articles:
+                lines.append(f"  - {article.title} (キー: {article.article_key})")
+            # Show remaining count if there are more articles than displayed
+            displayed_count = len(result.articles)
+            remaining_count = result.total_count - displayed_count
+            if remaining_count > 0:
+                lines.append(f"  ... 他 {remaining_count}件")
+            lines.append("")
+            lines.append(result.message)
+            return "\n".join(lines)
+
+        elif isinstance(result, BulkDeleteResult):
+            if result.total_count == 0:
+                return result.message
+
+            lines = [result.message]
+            if result.deleted_articles:
+                lines.append("")
+                lines.append("削除成功:")
+                for article in result.deleted_articles:
+                    lines.append(f"  - {article.title}")
+
+            if result.failed_articles:
+                lines.append("")
+                lines.append("削除失敗:")
+                for failed in result.failed_articles:
+                    lines.append(f"  - {failed.title}: {failed.error}")
+
+            return "\n".join(lines)
+
+        return str(result)
+
+    except NoteAPIError as e:
+        return f"一括削除に失敗しました: {e.message}"
+
+
+@mcp.tool()
+async def note_delete_article(
+    article_key: Annotated[str, "削除する記事のキー（例: n1234567890ab）"],
+    confirm: Annotated[bool, "削除を実行する場合はTrue、確認のみの場合はFalse"] = False,
+) -> str:
+    """公開記事を含む任意の記事を削除します。
+
+    note_delete_draft と異なり、公開済みの記事も削除できます。
+    **削除は取り消せません。**
+
+    2段階確認フロー:
+    1. confirm=False: 削除対象の記事情報を表示（実際の削除は行わない）
+    2. confirm=True: 実際に削除を実行
+
+    Args:
+        article_key: 削除する記事のキー
+        confirm: 削除を実行する場合はTrue（デフォルトはFalse）
+
+    Returns:
+        削除結果または確認メッセージ
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    try:
+        result = await delete_article(session, article_key, confirm=confirm)
+
+        from note_mcp.models import DeletePreview, DeleteResult
+
+        if isinstance(result, DeletePreview):
+            return (
+                f"削除対象の記事:\n"
+                f"  タイトル: {result.article_title}\n"
+                f"  キー: {result.article_key}\n"
+                f"  ステータス: {result.status.value}\n\n"
+                f"{result.message}"
+            )
+        elif isinstance(result, DeleteResult):
+            return result.message
+
+        return str(result)
+
+    except NoteAPIError as e:
+        return f"削除に失敗しました: {e.message}"
+
+
+@mcp.tool()
+async def note_unpublish_article(
+    article_key: Annotated[str, "下書きに戻す公開記事のキー（例: n1234567890ab）"],
+) -> str:
+    """公開記事を下書きに戻します。
+
+    公開済みの記事を下書き状態に戻します。記事の内容は保持されます。
+    すでに下書きの記事に対して実行するとエラーになります。
+
+    Args:
+        article_key: 下書きに戻す公開記事のキー
+
+    Returns:
+        下書きに戻した記事情報
+    """
+    session = _session_manager.load()
+    if session is None or session.is_expired():
+        return "セッションが無効です。note_loginでログインしてください。"
+
+    try:
+        article = await unpublish_article(session, article_key)
+        return (
+            f"記事を下書きに戻しました:\n"
+            f"  タイトル: {article.title}\n"
+            f"  キー: {article.key}\n"
+            f"  ステータス: draft\n"
+            f"  URL: {article.url}"
+        )
+
+    except NoteAPIError as e:
+        return f"下書き戻しに失敗しました: {e.message}"
+
+
+@mcp.tool(annotations={"readOnlyHint": True})
+async def note_search_public_articles(
+    query: Annotated[str, "検索キーワード"],
+    size: Annotated[int, "件数（1〜20）"] = 10,
+) -> str:
+    """note.com の公開記事をキーワード検索します（他人の記事・ログイン不要）。"""
+    from note_mcp.api.public_notes import search_public_notes
+
+    try:
+        result = await search_public_notes(query, size=size)
+    except NoteAPIError as e:
+        return f"検索に失敗しました: {e}"
+    if not result.items:
+        return f"「{query}」に一致する公開記事は見つかりませんでした。"
+    lines = [f"検索結果（{len(result.items)}件）クエリ: {query}"]
+    for item in result.items:
+        lines.append(f"  - {item.title} ({item.url}) 著者: {item.author_username}")
+    return "\n".join(lines)
+
+
+@mcp.tool(annotations={"readOnlyHint": True})
+async def note_fetch_public_article(
+    note_key_or_url: Annotated[str, "記事キー（n...）または https://note.com/.../n/... URL"],
+) -> str:
+    """公開記事の本文を取得します（他人の記事・ログイン不要）。"""
+    from note_mcp.api.public_notes import fetch_public_article
+
+    try:
+        article = await fetch_public_article(note_key_or_url)
+    except NoteAPIError as e:
+        return f"取得に失敗しました: {e}"
+    preview = article.body_markdown[:2000]
+    if len(article.body_markdown) > 2000:
+        preview += "\n...（省略）"
+    return (
+        f"タイトル: {article.title}\n"
+        f"著者: {article.author_username}\n"
+        f"URL: {article.url}\n"
+        f"ステータス: {article.status}\n\n"
+        f"{preview}"
+    )
+
+
+# Register investigator tools if in investigator mode
+if os.environ.get("INVESTIGATOR_MODE") == "1":
+    register_investigator_tools(mcp)