get_page_content
Fetch the content of a Scrapbox page using its URL with the Scrapbox MCP Server. Extract text data for analysis or integration into workflows.
Instructions
Fetch content from a Scrapbox page by URL
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Scrapbox page URL (e.g., https://scrapbox.io/project-name/page-title) |
Input Schema (JSON Schema)
{
"properties": {
"url": {
"description": "Scrapbox page URL (e.g., https://scrapbox.io/project-name/page-title)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
Implementation Reference
- src/index.ts:224-279 (handler)Main MCP call_tool handler that implements the get_page_content tool logic, including validation, URL parsing, API fetching, and error handling.server.setRequestHandler(CallToolRequestSchema, async (request) => { console.error("[Tool] Called:", request.params.name); if (request.params.name !== "get_page_content") { throw new McpError( ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}` ); } if (!isValidGetPageContentArgs(request.params.arguments)) { throw new McpError( ErrorCode.InvalidParams, "Invalid arguments: 'url' parameter is required and must be a string" ); } try { const { url } = request.params.arguments; const { projectName, pageTitle } = extractScrapboxInfo(url); const content = await fetchScrapboxPage(projectName, pageTitle); return { content: [ { type: "text", text: content } ] }; } catch (error) { console.error("[Error] Tool execution failed:", error); if (error instanceof McpError) { return { content: [ { type: "text", text: error.message } ], isError: true }; } return { content: [ { type: "text", text: `Error fetching Scrapbox content: ${error instanceof Error ? error.message : String(error)}` } ], isError: true }; } });
- src/index.ts:197-218 (registration)Tool registration in list_tools response, defining the get_page_content tool with name, description, and input schema.server.setRequestHandler(ListToolsRequestSchema, async () => { console.error("[Setup] Registering tools"); return { tools: [ { name: "get_page_content", description: "Fetch content from a Scrapbox page by URL", inputSchema: { type: "object", properties: { url: { type: "string", description: "Scrapbox page URL (e.g., https://scrapbox.io/project-name/page-title)" } }, required: ["url"] } } ] }; });
- src/index.ts:55-64 (schema)TypeScript interface defining input schema and validation function for get_page_content tool arguments.interface GetPageContentArgs { url: string; } /** * Validates if the input is a valid GetPageContentArgs object */ const isValidGetPageContentArgs = (args: any): args is GetPageContentArgs => { return typeof args === "object" && args !== null && typeof args.url === "string"; };
- src/index.ts:72-113 (helper)Helper function to parse Scrapbox URL and extract project name and page title.function extractScrapboxInfo(url: string): { projectName: string; pageTitle: string } { console.error("[URL] Processing URL:", url); try { const urlObj = new URL(url); // Validate that this is a Scrapbox URL if (urlObj.hostname !== "scrapbox.io") { throw new McpError( ErrorCode.InvalidParams, "Invalid URL: Not a Scrapbox URL" ); } // Extract project name and page title from path const pathParts = urlObj.pathname.split("/").filter(part => part); if (pathParts.length < 2) { throw new McpError( ErrorCode.InvalidParams, "Invalid URL format: Missing project name or page title" ); } const projectName = pathParts[0]; const pageTitle = decodeURIComponent(pathParts[1]); console.error("[URL] Extracted project:", projectName, "page:", pageTitle); return { projectName, pageTitle }; } catch (error) { if (error instanceof McpError) { throw error; } console.error("[Error] URL parsing failed:", error); throw new McpError( ErrorCode.InvalidParams, `Invalid URL format: ${error instanceof Error ? error.message : String(error)}` ); } }
- src/index.ts:122-176 (helper)Core helper function that calls Scrapbox API to fetch page data and formats it into markdown content.async function fetchScrapboxPage(projectName: string, pageTitle: string): Promise<string> { const apiUrl = `https://scrapbox.io/api/pages/${encodeURIComponent(projectName)}/${encodeURIComponent(pageTitle)}`; console.error("[API] Request to endpoint:", apiUrl); try { const response = await axios.get<ScrapboxPage>(apiUrl); const page = response.data; // Format the page content let formattedContent = `# ${page.title}\n\n`; // Add descriptions if available if (page.descriptions && page.descriptions.length > 0) { formattedContent += "## 概要\n"; formattedContent += page.descriptions.join("\n") + "\n\n"; } // Add content from lines formattedContent += "## 内容\n"; formattedContent += page.lines .slice(1) // Skip the first line (title) .map(line => line.text) .join("\n"); // Add metadata formattedContent += "\n\n## メタデータ\n"; formattedContent += `- 作成日時: ${new Date(page.created).toISOString()}\n`; formattedContent += `- 更新日時: ${new Date(page.updated).toISOString()}\n`; formattedContent += `- 閲覧数: ${page.views}\n`; formattedContent += `- リンク数: ${page.linked}\n`; return formattedContent; } catch (error) { console.error("[Error] API request failed:", error); if (axios.isAxiosError(error)) { if (error.response?.status === 404) { throw new McpError( ErrorCode.InvalidParams, "Page not found: The requested Scrapbox page does not exist" ); } throw new McpError( ErrorCode.InternalError, `Scrapbox API error: ${error.response?.data?.message || error.message}` ); } throw new McpError( ErrorCode.InternalError, `Failed to fetch Scrapbox page: ${error instanceof Error ? error.message : String(error)}` ); } }