ScreenshotOne

เซิร์ฟเวอร์ MCP ของ ScreenshotOne

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

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

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

เครื่องมือ

• render-website-screenshot: แสดงภาพหน้าจอของเว็บไซต์และส่งคืน 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 ภาพหน้าจอพร้อมใช้งานสูงสุดสี่ชั่วโมง ในขณะที่เนื้อหาข้อมูลเมตาจะรวมเวลาหมดอายุที่แน่นอน ดาวน์โหลดไฟล์ใดๆ ที่คุณต้องการเก็บไว้

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

การใช้งาน

สร้างมัน

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

npm install && npm run build

รับคีย์ API ของ ScreenshotOne

ลงทะเบียนที่ ScreenshotOne และรับคีย์ API ของคุณ

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

เรียกใช้ CLI โดยตรงจากแพ็กเกจ npm โดยไม่ต้องโคลนที่เก็บ:

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>"
            }
        }
    }
}

แบบสแตนด์อโลนหรือสำหรับโปรเจกต์อื่นๆ

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

ใบอนุญาต

ScreenshotOne MCP Server ได้รับอนุญาต ภายใต้ใบอนุญาต MIT