ScreenshotOne

ScreenshotOne MCP Server

การติดตั้งใช้งานอย่างเป็นทางการของเซิร์ฟเวอร์ MCP (Model Context Protocol) สำหรับ ScreenshotOne

คำอธิบายเพิ่มเติมเล็กน้อยเกี่ยวกับเหตุผลที่สร้างขึ้นและแนวคิดบางประการเกี่ยวกับอนาคตของ MCP

ScreenshotOne ยังมีเซิร์ฟเวอร์ MCP แบบโฮสต์อย่างเป็นทางการด้วย ดู การผสานรวม ScreenshotOne MCP สำหรับคำแนะนำในการตั้งค่าและการอัปเดตล่าสุด

เครื่องมือ

• render-website-screenshot: จับภาพหน้าจอเว็บไซต์และส่งคืน URL ชั่วคราวของภาพหน้าจอ เนื้อหา และส่วนภาพ ตามที่ร้องขอ
• render-website-screenshot-as-file: จับภาพหน้าจอเว็บไซต์หรือ PDF และส่งคืนไฟล์โดยตรง โดยฝังไว้ในคำตอบเป็นทรัพยากร MCP พร้อม URL ชั่วคราว
• extract-website-markdown: แสดงผลเว็บไซต์และส่งคืนเนื้อหา Markdown ที่ผ่านการปรับแต่งแล้วเป็นข้อความโดยตรง
• get-usage: ดูโควตา API และการใช้งานพร้อมกันของ ScreenshotOne

เครื่องมือจับภาพหน้าจอมีตัวเลือกเฉพาะดังนี้:

• url
• block_banners (ค่าเริ่มต้นคือ true)
• block_ads (ค่าเริ่มต้นคือ true)
• image_quality (ค่าเริ่มต้นคือ 80)
• full_page (ค่าเริ่มต้นคือ false)
• full_page_slices (ค่าเริ่มต้นคือ false; ต้องใช้ full_page=true)
• metadata_content (ค่าเริ่มต้นคือ false)
• metadata_content_format (html หรือ markdown; ต้องใช้ metadata_content=true)

ชื่อและค่าตัวเลือกสำหรับเนื้อหาข้อมูลเมตาและส่วนภาพแบบเต็มหน้าจะตรงกับ API ของ ScreenshotOne เครื่องมือนี้ไม่มีตัวควบคุมประเภทการตอบกลับหรือแคช โดยจะร้องขอการตอบกลับแบบ JSON และปิดใช้งานการแคช API เสมอ

กำหนดค่า metadata_content=true และ metadata_content_format=markdown เพื่อรับ URL เนื้อหา Markdown ชั่วคราวพร้อมภาพหน้าจอ กำหนดค่า full_page=true และ full_page_slices=true เพื่อรับ URL ภาพหน้าจอแนวตั้งขนาดเล็กลง ระบบแนะนำให้ใช้ส่วนภาพเมื่อเอเจนต์ AI ต้องวิเคราะห์หน้าเว็บยาวที่อาจประมวลผลได้ไม่เสถียรหากเป็นภาพขนาดใหญ่ภาพเดียว

การจับภาพที่สำเร็จจะส่งคืน URL ที่ร้องขอเป็นข้อความและเนื้อหาแบบมีโครงสร้าง:

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

URL เหล่านี้เป็น URL ชั่วคราว โดย URL ภาพหน้าจอจะใช้งานได้สูงสุดสี่ชั่วโมง ส่วนเนื้อหาข้อมูลเมตาจะระบุเวลาหมดอายุที่แน่นอน ดาวน์โหลดไฟล์ที่ต้องการเก็บไว้

render-website-screenshot-as-file เหมาะสำหรับไคลเอ็นต์ที่ต้องการไฟล์โดยตรง เช่น เพื่อบันทึกหรือแนบไฟล์ หรือไม่สามารถดาวน์โหลดลิงก์ได้ เครื่องมือนี้รับ url, format (ค่าเริ่มต้นคือ jpg, png, webp, gif, jp2, tiff, avif, heif หรือ pdf), block_banners, block_ads, image_quality, full_page และ full_page_max_height (ต้องใช้ full_page=true) เครื่องมือจะส่งคืนไฟล์เป็นทรัพยากรที่ฝังไว้ (type: "resource" พร้อม blob ที่เข้ารหัสแบบ base64 และประเภท MIME) รวมถึงชื่อ URI ประเภท MIME ขนาด และ URL ชั่วคราวในรูปแบบข้อความและเนื้อหาแบบมีโครงสร้าง ไฟล์ที่มีขนาดใหญ่กว่า 5 MB จะไม่ถูกฝัง เครื่องมือจะแสดงข้อผิดพลาดพร้อมคำแนะนำให้ใช้รูปแบบ คุณภาพ หรือความสูงที่เล็กลง และระบุ URL ชั่วคราวไว้ด้วย

extract-website-markdown รับเฉพาะ url เท่านั้น เป็นทางลัดเฉพาะสำหรับคำขอ API ของ format=markdown ของ ScreenshotOne และส่งคืน Markdown ที่ได้โดยตรงในการตอบกลับข้อความ MCP เพียงครั้งเดียว ใช้เมื่อเอเจนต์ต้องอ่านหรือวิเคราะห์เนื้อหาหน้าเว็บโดยไม่ต้องใช้ภาพหน้าจอ

การใช้งาน

สร้าง

ติดตั้ง dependencies และ build ก่อนเสมอ:

npm install && npm run build

รับ API key ของ ScreenshotOne

สมัครใช้งานที่ ScreenshotOne แล้วรับ API key ของคุณ

เรียกใช้ด้วย npx

เรียกใช้ CLI โดยตรงจากแพ็กเกจ npm โดยไม่ต้อง clone repository:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

ใช้กับ Claude for Desktop

เพิ่มรายการต่อไปนี้ลงใน ~/Library/Application\ Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

ใช้งานแบบ Standalone หรือกับโปรเจกต์อื่น

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

ใบอนุญาต

ScreenshotOne MCP Server เผยแพร่ภายใต้ ใบอนุญาต MIT