Zip1

ทางการ

เครื่องย่อ URL ฟรี

คุณทำอะไรได้บ้างด้วย Zip1 MCP?

  • ย่อ URL — ขอให้ผู้ช่วยสร้างลิงก์สั้นจาก URL ที่ถูกต้องใดๆ โดยใช้ create_short_url
  • นามแฝงและรหัสผ่านที่กำหนดเอง — ขอลิงก์สั้นแบบมีแบรนด์พร้อมนามแฝงที่กำหนดเองและตัวเลือกการป้องกันด้วยรหัสผ่านผ่าน create_short_url
  • ตรวจสอบความถูกต้องของ URL — ถามว่า URL สามารถย่อได้หรือไม่ก่อนสร้างลิงก์ โดยใช้เครื่องมือ validate_url
  • ดึงข้อมูลการวิเคราะห์ลิงก์ — รับจำนวนคลิก ผู้เข้าชมที่ไม่ซ้ำ และประเทศอันดับต้นๆ สำหรับรหัสสั้นใดๆ ด้วย get_url_stats
  • สร้างรหัสสั้น — ขอคำแนะนำรหัสสั้นแบบสุ่มเพื่อใช้เป็นนามแฝงที่กำหนดเอง

เอกสาร

🤖 การผสานรวม AI (MCP)

ใช้ zip1.io โดยตรงจากผู้ช่วย AI เช่น Claude ผ่าน Model Context Protocol (MCP) ย่อ URL ดึงข้อมูลวิเคราะห์ และจัดการลิงก์ด้วยคำสั่งภาษาธรรมชาติ

🤖

การจัดการ URL ด้วย AI

พูดคุยกับตัวย่อ URL ของคุณเหมือนพูดคุยกับ AI

  • ✨ อินเทอร์เฟซภาษาธรรมชาติ - ไม่ต้องใช้ไวยากรณ์ API
  • ⚡ ย่อ URL ได้ทันทีจากผู้ช่วย AI ของคุณ
  • 📊 รับข้อมูลวิเคราะห์ตามต้องการด้วยคำสั่งง่ายๆ
  • 🔒 สร้างลิงก์ที่ป้องกันด้วยรหัสผ่านผ่านการสนทนา

⚡ การตั้งค่าด่วน

สำหรับ Claude Code (แนะนำ)

Claude Code รองรับเซิร์ฟเวอร์ MCP แบบ HTTP โดยตรงผ่าน CLI เพียงรัน:

claude mcp add --transport http zip1 https://zip1.io/mcp

ตรวจสอบการติดตั้ง:

claude mcp list

✅ เสร็จเรียบร้อย! ตอนนี้คุณสามารถใช้ zip1.io โดยตรงจาก Claude Code ได้แล้ว

สำหรับ Claude Desktop

⚠️ ต้องใช้พร็อกซี: Claude Desktop รองรับเฉพาะเซิร์ฟเวอร์ MCP แบบ stdio เท่านั้น ไม่รองรับเซิร์ฟเวอร์ HTTP คุณจะต้องใช้พร็อกซีในเครื่องเพื่อเชื่อมต่อ

ตัวเลือกที่ 1: ใช้ mcp-client-cli (แนะนำ)

ติดตั้งเครื่องมือ MCP client CLI เพื่อเชื่อมต่อ stdio กับ HTTP:

npm install -g @modelcontextprotocol/client-cli

จากนั้นแก้ไขไฟล์คอนฟิกของ Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

เพิ่มคอนฟิกนี้:

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["https://zip1.io/mcp"]
    }
  }
}

รีสตาร์ท Claude Desktop แล้วเครื่องมือ zip1.io จะพร้อมใช้งาน

ตัวเลือกที่ 2: Node.js พร็อกซีแบบกำหนดเอง

สำหรับผู้ใช้ขั้นสูง สร้างสคริปต์บริดจ์ stdio-to-HTTP แบบกำหนดเอง:

#!/usr/bin/env node
const https = require('https');
const readline = require('readline');

const MCP_URL = 'https://zip1.io/mcp';

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  terminal: false
});

rl.on('line', (line) => {
  const request = JSON.parse(line);

  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    }
  };

  const req = https.request(MCP_URL, options, (res) => {
    let data = '';
    res.on('data', (chunk) => data += chunk);
    res.on('end', () => {
      console.log(data);
    });
  });

  req.on('error', (error) => {
    console.error(JSON.stringify({
      jsonrpc: '2.0',
      id: request.id,
      error: { code: -32000, message: error.message }
    }));
  });

  req.write(JSON.stringify(request));
  req.end();
});

ทำให้ไฟล์สามารถรันได้และเพิ่มลงในคอนฟิก Claude Desktop ของคุณ:

chmod +x zip1-mcp-proxy.js
{
  "mcpServers": {
    "zip1": {
      "command": "node",
      "args": ["/path/to/zip1-mcp-proxy.js"]
    }
  }
}

⚙️ การกำหนดค่าเซิร์ฟเวอร์

เซิร์ฟเวอร์ MCP ของ zip1.io พร้อมใช้งานเป็นเอนด์พอยต์ HTTP ที่ไคลเอนต์ที่รองรับ MCP ใดๆ สามารถเชื่อมต่อได้

รายละเอียดเซิร์ฟเวอร์

รายการกำหนดค่าค่า
URL เซิร์ฟเวอร์https://zip1.io/mcp
การส่งข้อมูลHTTP (Streamable)
เวอร์ชันโปรโตคอลMCP 2024-11-05
รูปแบบข้อความJSON-RPC 2.0
การรับรองความถูกต้องไม่มี (จำกัดอัตรา)
การจำกัดอัตรา30 คำขอ/นาทีต่อ IP
เครื่องมือที่มี4 (create_short_url, get_url_stats, validate_url, generate_short_code)

การใช้กับไคลเอนต์ MCP อื่นๆ

ไคลเอนต์ที่รองรับ MCP ใดๆ ที่รองรับการส่งข้อมูลแบบ HTTP สามารถเชื่อมต่อกับ zip1.io ได้ นี่คือตัวอย่างบางส่วน:

คำขอ HTTP โดยตรง (curl)

curl -X POST https://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
curl -X POST https://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_short_url",
      "arguments": {
        "url": "https://example.com",
        "alias": "my-link"
      }
    }
  }'

ตัวอย่างไคลเอนต์ Python

import requests

MCP_URL = "https://zip1.io/mcp"

def call_mcp_tool(tool_name, arguments):
    payload = {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": tool_name,
            "arguments": arguments
        }
    }

    response = requests.post(MCP_URL, json=payload)
    return response.json()

# Example usage
result = call_mcp_tool("create_short_url", {
    "url": "https://github.com/anthropics/claude-mcp",
    "alias": "mcp-docs"
})

print(result)

การกำหนดค่าแบบโฮสต์เอง

หากคุณรันอินสแตนซ์ zip1.io ของคุณเอง กำหนดค่าไคลเอนต์ให้ชี้ไปที่อินสแตนซ์ของคุณ:

claude mcp add --transport http zip1 https://your-domain.com/mcp
{
  "mcpServers": {
    "zip1-local": {
      "command": "mcp-client",
      "args": ["http://localhost:8000/mcp"]
    }
  }
}

💬 ตัวอย่างการสนทนา

นี่คือพรอมต์ภาษาธรรมชาติบางส่วนที่คุณสามารถใช้กับ Claude:

การสร้าง URL สั้น

"Shorten https://github.com/anthropics/claude-mcp for me"

คำตอบของ Claude:
✅ สร้าง URL สั้นแล้ว: https://zip1.io/\[code\]
🔤 รหัสที่สร้าง: [code]
🔗 URL ต้นฉบับ: https://github.com/anthropics/claude-mcp
📊 ดูสถิติ: https://zip1.io/stats/\[code\]

นามแฝงและรหัสผ่านแบบกำหนดเอง

"Create a short URL for https://docs.myapp.com with alias 'docs' and password 'team2024@'"

คำตอบของ Claude:
✅ สร้าง URL สั้นแล้ว: https://zip1.io/docs
📝 นามแฝงที่กำหนด: docs
🔒 ป้องกันด้วยรหัสผ่าน: ใช่
🔗 URL ต้นฉบับ: https://docs.myapp.com

การรับข้อมูลวิเคราะห์

"Show me the stats for short code 'docs'"

คำตอบของ Claude:
📊 สถิติสำหรับ: https://zip1.io/docs
👆 คลิกทั้งหมด: 127
👤 คลิกไม่ซ้ำ: 89
🔒 ป้องกันด้วยรหัสผ่าน: ใช่
📅 สร้างเมื่อ: 2024-01-15T10:30:00

🌍 ประเทศสูงสุด:
1. สหรัฐอเมริกา: 54 คลิก
2. สหราชอาณาจักร: 23 คลิก
3. แคนาดา: 18 คลิก

การตรวจสอบ URL

"Can I shorten ftp://myserver.com/file.zip?"

คำตอบของ Claude:
❌ URL ไม่ถูกต้อง: ต้องมีโปรโตคอล http:// หรือ https:// และโดเมนที่ถูกต้อง

🛠️ เครื่องมือที่มี

เซิร์ฟเวอร์ MCP ของ zip1.io มีเครื่องมือสี่อย่างที่ Claude สามารถใช้ได้:

เครื่องมือคำอธิบายตัวอย่างการใช้งาน
create_short_urlสร้าง URL สั้นพร้อมนามแฝง รหัสผ่าน และจำนวนคลิกสูงสุดที่กำหนดได้"ย่อ URL นี้ด้วยนามแฝง 'mylink'"
get_url_statsดึงข้อมูลวิเคราะห์โดยละเอียด รวมถึงคลิก ประเทศ และเวลาประทับ"ดูสถิติสำหรับรหัสสั้น 'abc123'"
validate_urlตรวจสอบว่า URL ถูกต้องและสามารถย่อได้หรือไม่"ฉันย่อ example.com ได้ไหม?"
generate_short_codeสร้างข้อเสนอรหัสสั้นแบบสุ่ม"สร้างรหัสสั้นแบบสุ่ม"

description บน create_short_url เป็นหมายเหตุส่วนตัวที่ไม่บังคับสำหรับการผสานรวมของคุณเอง สูงสุด 100 ตัวอักษร จะไม่แสดงบนหน้าสาธารณะของลิงก์ เก็บให้ปราศจากข้อมูลส่วนบุคคลที่คุณไม่ต้องการจัดเก็บ การตอบสนองจากการสร้างจะส่งคืนค่านี้

🔧 รายละเอียดทางเทคนิค

เอนด์พอยต์ MCP

GET /mcp

ส่งคืนข้อมูลเซิร์ฟเวอร์ เครื่องมือที่มี และรายละเอียดการกำหนดค่า

ข้อมูลโปรโตคอล

  • เวอร์ชันโปรโตคอล: MCP 2024-11-05
  • การส่งข้อมูล: Streamable HTTP
  • รูปแบบข้อความ: JSON-RPC 2.0
  • การจำกัดอัตรา: 30 คำขอต่อนาทีต่อ IP

ความปลอดภัย

  • การสื่อสารทั้งหมดใช้การเข้ารหัส HTTPS
  • รหัสผ่านถูกแฮชด้วย bcrypt ก่อนจัดเก็บ
  • การจำกัดอัตราป้องกันการใช้งานในทางที่ผิด
  • โครงสร้างพื้นฐานความปลอดภัยเดียวกันกับ REST API

💡 กรณีการใช้งาน

📝 การสร้างเนื้อหา

สร้าง URL สั้นขณะเขียนบล็อกโพสต์ เอกสาร หรือเนื้อหาโซเชียลมีเดียโดยไม่ต้องออกจากผู้ช่วย AI ของคุณ

📊 ข้อมูลวิเคราะห์ด่วน

สอบถามประสิทธิภาพลิงก์ระหว่างการสนทนา "ลิงก์แคมเปญของฉันมีคลิกกี่ครั้ง?"

🔐 การแชร์อย่างปลอดภัย

สร้างลิงก์ที่ป้องกันด้วยรหัสผ่านได้ทันทีเมื่อแชร์ข้อมูลที่ละเอียดอ่อนในแชททีม

🎯 การจัดการแคมเปญ

สร้าง URL ที่มีนามแฝงกำหนดเองสำหรับแคมเปญการตลาดด้วยคำสั่งภาษาธรรมชาติ

🔍 การแก้ไขปัญหา

เกิดข้อผิดพลาดการจำกัดอัตรา?

  • เอนด์พอยต์ MCP มีขีดจำกัด 30 คำขอต่อนาที
  • รอสักครู่แล้วลองอีกครั้ง

เครื่องมือไม่ปรากฏใน Claude Code?

  • ตรวจสอบว่า URL เซิร์ฟเวอร์ MCP เข้าถึงได้
  • ลองเยี่ยมชม https://zip1.io/mcp ในเบราว์เซอร์ของคุณ
  • ตรวจสอบการกำหนดค่า MCP ของคุณด้วย claude mcp list

📚 แหล่งข้อมูลและเอกสาร

พร้อมเริ่มต้นใช้งานหรือยัง?

เพิ่ม zip1.io ลงใน Claude Code ตอนนี้และเริ่มย่อ URL ด้วย AI

claude mcp add --transport http zip1 https://zip1.io/mcp