Rivalize

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

ข้อมูลข่าวกรองการแข่งขันที่มีแหล่งอ้างอิงและวันที่ สำหรับผู้ช่วย AI ของคุณ ผ่านโปรโตคอลบริบทของโมเดล (Model Context Protocol)

ฟีเจอร์

เซิร์ฟเวอร์นี้เชื่อมต่อ Claude, Cursor หรือไคลเอนต์ MCP อื่น ๆ เข้ากับ Rivalize ผู้ช่วยของคุณสามารถวิเคราะห์จุดยืน ราคา โฆษณา การปรากฏบนโซเชียล รีวิว การจ้างงาน และโมเมนตัมของคู่แข่งได้ในการเรียกครั้งเดียว ค้นหาจักรวาลของบริษัทที่ติดตามของ Rivalize และอ่านโปรเจกต์ รายงาน แบทเทิลการ์ด ไทม์ไลน์ และหลักฐานในบัญชี Rivalize ของคุณเอง ทุกคำตอบมาจากข้อมูลที่ Rivalize เก็บรวบรวม พร้อมวันที่และแหล่งอ้างอิง ไม่ใช่จากความทรงจำของโมเดล

เซิร์ฟเวอร์เป็นแบบอ่านอย่างเดียวโดยค่าเริ่มต้น เครื่องมือเขียนหนึ่งตัวคือ add_competitor พร้อมใช้งานเมื่อคุณเลือกใช้ด้วย RIVALIZE_MCP_ALLOW_WRITES=1

เริ่มต้นอย่างรวดเร็ว

ต้องใช้ Node.js 22 หรือใหม่กว่า (node --version)

1. สร้างบัญชีที่ rivalize.ai
2. สร้างคีย์ API ภายใต้ แดชบอร์ด → การตั้งค่า → คีย์ API คีย์เริ่มต้นด้วย rk_live_ คีย์จากแผนใดก็ได้ใช้งานได้ รวมถึงแผนฟรีซึ่งมีการจำกัดอัตราการอ่าน
3. เพิ่มเซิร์ฟเวอร์ลงในไคลเอนต์ของคุณโดยใช้บล็อกใดบล็อกหนึ่งด้านล่าง

Claude Desktop

แก้ไข ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) หรือ %APPDATA%\Claude\claude_desktop_config.json (Windows) จากนั้นรีสตาร์ท Claude Desktop:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Claude Code

claude mcp add rivalize -e RIVALIZE_API_KEY=rk_live_... -- npx -y @rivalize/mcp

Cursor

เพิ่มใน .cursor/mcp.json ในโปรเจกต์ของคุณ หรือ ~/.cursor/mcp.json สำหรับทุกโปรเจกต์:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

Cline

ใน Cline เปิดแผง MCP Servers เลือก Configure จากนั้น Configure MCP Servers ซึ่งจะเปิด cline_mcp_settings.json เพิ่ม:

{
  "mcpServers": {
    "rivalize": {
      "command": "npx",
      "args": ["-y", "@rivalize/mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

บันทึกไฟล์ เซิร์ฟเวอร์ rivalize จะปรากฏพร้อมจุดสีเขียวหลังจากประมาณ 10 ถึง 15 วินาที (การเริ่มครั้งแรกจะดาวน์โหลดแพ็กเกจ) บน Windows หากไม่เริ่มทำงาน ให้ใช้ "command": "cmd" และ "args": ["/c", "npx", "-y", "@rivalize/mcp"]

หากคุณขอให้ Cline ติดตั้งให้ ชี้ไปที่ llms-install.md

ไคลเอนต์ MCP ใด ๆ (stdio)

เซิร์ฟเวอร์พูดภาษา MCP ผ่าน stdin และ stdout กำหนดค่าไคลเอนต์ของคุณให้เปิดใช้:

การตั้งค่า	ค่า
คำสั่ง	npx
อาร์กิวเมนต์	-y @rivalize/mcp
สภาพแวดล้อม	RIVALIZE_API_KEY=rk_live_...
การขนส่ง	stdio

บน Windows ไคลเอนต์บางตัวไม่สามารถเปิด npx โดยตรงได้เนื่องจากเป็น npx.cmd ให้ใช้ cmd เป็นคำสั่งและ /c npx -y @rivalize/mcp เป็นอาร์กิวเมนต์แทน

เครื่องมือ

เครื่องมือแบบอ่านอย่างเดียวสิบสามตัวพร้อมใช้งานเสมอ add_competitor ลงทะเบียนเฉพาะเมื่อ RIVALIZE_MCP_ALLOW_WRITES ถูกตั้งค่าเป็น 1, true หรือ yes; หากไม่ตั้งค่า เครื่องมือนี้จะไม่มีอยู่สำหรับไคลเอนต์

เครื่องมือ	การเข้าถึง	ฟังก์ชัน	อาร์กิวเมนต์หลัก
teardown_competitor	อ่าน	วิเคราะห์กลยุทธ์คู่แข่งแบบครบวงจรในครั้งเดียวเป็น Markdown: จุดยืน ราคา โฆษณา โซเชียล รีวิว การจ้างงาน โมเมนตัม และจุดอ่อนที่ควรโจมตี พร้อมเวลาที่ข้อมูลถูกรีเฟรชล่าสุด	domain (จำเป็น)
list_universe_companies	อ่าน	ค้นหาจักรวาลของ Rivalize ชุดข้อมูลข้ามลูกค้าของบริษัทที่ติดตาม	q, category (slug), layer, limit (1-100), offset
get_universe_company	อ่าน	โปรไฟล์จักรวาลเต็มรูปแบบสำหรับหนึ่งบริษัท: ข้อมูลประจำตัว ราคา ฟีเจอร์ โฆษณา โซเชียล รีวิว การระดมทุนและการจ้างงาน การจัดอันดับ สัญญาณ โมเมนตัม	domain (จำเป็น), layers
list_projects	อ่าน	โปรเจกต์ในบัญชีของคุณ; ส่งคืน project_id ที่เครื่องมืออื่นใช้	ไม่มี
list_reports	อ่าน	รายงานของคุณ เรียงจากใหม่ไปเก่า การอ่านไม่เคยสร้างรายงาน	project_id, limit (1-100), offset
get_report	อ่าน	รายงานหนึ่งฉบับเป็น Markdown ทั้งฉบับหรือส่วนเดียวหรือคู่แข่งเดียวในแต่ละครั้ง	report_id (จำเป็น), section, competitor, page
list_competitors	อ่าน	คู่แข่งที่คุณติดตาม พร้อมคะแนนโมเมนตัม ระดับภัยคุกคาม และจุดยืนของคู่แข่งแต่ละรายใน Brief ของคุณหาก API ให้ข้อมูล	project_id, limit (1-100), offset
get_competitor_intelligence	อ่าน	ข้อมูลข่าวกรองล่าสุดที่เก็บไว้สำหรับคู่แข่งที่ติดตามหนึ่งราย; ฟิลด์จะปรากฏเฉพาะเมื่อมีการวัดค่า	competitor_id (จำเป็น)
get_battlecard	อ่าน	แบทเทิลการ์ดขายพร้อมแหล่งอ้างอิงสำหรับคู่แข่งที่ติดตามหนึ่งราย ต้องใช้แผน Pro	competitor_id (จำเป็น)
get_strategic_timeline	อ่าน	ไทม์ไลน์การเคลื่อนไหวของคู่แข่งพร้อมหลักฐาน ครอบคลุมราคา ผลิตภัณฑ์ บุคลากร การระดมทุน และเนื้อหา/โซเชียล	project_id (จำเป็น), days (30, 90, 180), competitor_id, lanes, format, page
get_competitive_landscape	อ่าน	ตำแหน่งรายสัปดาห์ปัจจุบันหรือที่เก็บไว้ของคู่แข่งตามกิจกรรมและความสำคัญเชิงกลยุทธ์	project_id (จำเป็น), week (YYYY-MM-DD), format, page
get_freshness	อ่าน	เวลาที่คู่แข่งที่ติดตามแต่ละรายในโปรเจกต์ถูกสังเกตจริงครั้งล่าสุด และอย่างไร	project_id (จำเป็น)
get_evidence	อ่าน	แหล่งที่มาของข้อเท็จจริงสำหรับผลิตภัณฑ์ของคุณหรือคู่แข่งหนึ่งราย: URL สิ่งที่สนับสนุน และเวลาที่อ่าน	project_id (จำเป็น), competitor_id
add_competitor	เขียน, เลือกใช้	เพิ่ม URL คู่แข่งลงในโปรเจกต์ ใช้เครดิตและจัดคิวการวิเคราะห์	project_id (จำเป็น), urls (1-10, จำเป็น)

project_id และ competitor_id เป็น UUID จาก list_projects และ list_competitors เครื่องมือที่อ่านบัญชีของคุณจะเห็นเฉพาะข้อมูลของคุณเองเท่านั้น

ส่วนของรายงาน

get_report รับ section เพื่อให้ผู้ช่วยของคุณอ่านส่วนที่คำถามต้องการแทนที่จะอ่านทั้งรายงาน:

ส่วน	เนื้อหา
tldr, biggest-threat, blind-spots, actions	ส่วนหัวข้อหลักของรายงาน (actions คือสิ่งที่ผลิตภัณฑ์ของคุณควรทำ)
battlecards	แบทเทิลการ์ดขายพร้อมแหล่งอ้างอิง
competitors	ส่วนของคู่แข่งทุกคนแบบเต็มรูปแบบ
pricing, momentum, app-store, strengths, weaknesses, key-findings, creators, ads, tech-stack	หัวข้อเดียวที่รวบรวมจากส่วนของคู่แข่งทุกคน

รายงานมีเฉพาะส่วนที่มีข้อมูลเท่านั้น; การขอชื่ออื่นจะส่งคืนข้อผิดพลาดที่แสดงรายการส่วนที่มี section รวมกับ competitor ดังนั้น section: "pricing" กับ competitor: "Acme" จะส่งคืนราคาของ Acme ข้อเรียกร้องที่การตรวจสอบการสร้างข้อมูลของรายงานลบออกจะปรากฏเป็น [removed — unverified] เช่นเดียวกับในรายงาน

การตอบกลับแบบยาว

ทุกการตอบกลับอยู่ภายใต้ 25,000 ตัวอักษร และไม่มีอะไรถูกตัดออกอย่างเงียบ ๆ:

• Markdown (get_report, get_strategic_timeline, get_competitive_landscape) ถูกแบ่งเป็นหน้า ๆ ที่ขอบเขตส่วน แต่ละหน้าเริ่มต้นด้วย Page N of M, จำนวนที่เหลือ และการเรียกที่แน่นอนสำหรับหน้าถัดไป
• รายการ (list_universe_companies, list_competitors, list_reports) ส่งคืน pagination.next_offset; ดำเนินการต่อจากนั้นจนกว่าจะเป็น null
• ออบเจกต์ (get_universe_company, และไทม์ไลน์หรือแลนด์สเคป JSON) จำกัดอาร์เรย์ยาวและบันทึกขีดจำกัดใน _capped ฟิลด์ที่ยังไม่พอดีจะถูกระบุใน _omitted พร้อมการเรียกที่ดึงข้อมูลนั้น

ตัวอย่างพรอมต์

• "วิเคราะห์ linear.app" (teardown_competitor)
• "ใครคือผู้เล่นในเครื่องมือพัฒนา AI?" (list_universe_companies)
• "สรุปรายงานล่าสุดของฉัน แล้วแสดงราคาที่คู่แข่งเรียกเก็บ" (list_reports, get_report กับ section: "pricing")
• "คู่แข่งคนไหนของฉันเคลื่อนไหวมากที่สุดในไตรมาสนี้ และพวกเขาทำอะไร?" (get_competitive_landscape, get_strategic_timeline)
• "ให้ประเด็นพูดคุยการขายกับคู่แข่งอันดับต้นของฉัน" (list_competitors, get_battlecard)
• "ข้อเรียกร้องเรื่องราคานั้นมาจากไหน และข้อมูลสดแค่ไหน?" (get_evidence, get_freshness)

การกำหนดค่า

ตัวแปร	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
RIVALIZE_API_KEY	ใช่	ไม่มี	คีย์ API ของ Rivalize ของคุณ ต้องเริ่มต้นด้วย rk_live_; เซิร์ฟเวอร์จะออกจากระบบเมื่อเริ่มต้นพร้อมข้อความหากคีย์หายไปหรือไม่ถูกต้อง
RIVALIZE_API_URL	ไม่	https://rivalize.ai	ต้นทางของ API Rivalize คีย์ใช้งานได้เฉพาะกับเซิร์ฟเวอร์ที่ออกคีย์เท่านั้น: ปล่อยว่างไว้สำหรับ rivalize.ai และสำหรับเซิร์ฟเวอร์ Rivalize ที่โฮสต์เองหรือไม่ใช่โปรดักชัน ให้ตั้งค่าเป็นต้นทางของเซิร์ฟเวอร์นั้น มิฉะนั้นทุกการเรียกจะส่งคืน 401
RIVALIZE_MCP_ALLOW_WRITES	ไม่	ปิด	1, true หรือ yes (ตัวพิมพ์ใดก็ได้) ลงทะเบียน add_competitor ค่าอื่นใดหรือไม่ตั้งค่าจะทำให้เซิร์ฟเวอร์เป็นแบบอ่านอย่างเดียว
HTTPS_PROXY / HTTP_PROXY	ไม่	ไม่มี	ส่งคำขอผ่านพร็อกซีองค์กร รูปแบบตัวพิมพ์เล็กก็ถูกอ่านเช่นกัน และ HTTPS_PROXY ชนะเมื่อตั้งค่าทั้งสอง NO_PROXY ถือเป็นที่เคารพ ข้อผิดพลาดระบุชื่อโฮสต์พร็อกซี ไม่ใช่ข้อมูลประจำตัว

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

"การเชื่อมต่อปิด"

เมื่อเซิร์ฟเวอร์ไม่สามารถเริ่มทำงาน ไคลเอนต์หลายตัวแสดงเพียง "การเชื่อมต่อปิด" หรือสถานะล้มเหลว เซิร์ฟเวอร์พิมพ์สาเหตุเป็นบรรทัดแรกของ stderr โดยมีคำนำหน้า rivalize-mcp: และไคลเอนต์ส่วนใหญ่เก็บ stderr ไว้ในบันทึก MCP ของตน สาเหตุทั่วไป:

1. RIVALIZE_API_KEY หายไปหรือไม่ถูกต้อง บันทึกอ่านว่า rivalize-mcp: RIVALIZE_API_KEY is required หรือบอกว่าคีย์ดูไม่เหมือนคีย์ API ของ Rivalize (ต้องเริ่มต้นด้วย rk_live_) ใส่คีย์ในบล็อก env ของเซิร์ฟเวอร์แล้วรีสตาร์ทไคลเอนต์
2. Node.js เก่ากว่า 22 รัน node --version และติดตั้ง Node.js 22 หรือใหม่กว่า ไคลเอนต์ของคุณใช้ node และ npx ที่พบก่อนใน PATH ของตัวเอง ซึ่งอาจแตกต่างจากเทอร์มินัลของคุณ
3. ไม่มีการเข้าถึงเครือข่าย npx ดาวน์โหลดแพ็กเกจในการรันครั้งแรก และทุกการเรียกเครื่องมือไปที่ https://rivalize.ai (หรือ RIVALIZE_API_URL) หลังพร็อกซีองค์กร ตั้งค่า HTTPS_PROXY ข้อผิดพลาดเครือข่ายระบุชื่อเซิร์ฟเวอร์และรหัสสาเหตุ เช่น ECONNREFUSED หรือ ENOTFOUND

เพื่อดูข้อความโดยตรง รันเซิร์ฟเวอร์ในเทอร์มินัลด้วยคีย์เดียวกัน:

RIVALIZE_API_KEY=rk_live_... npx -y @rivalize/mcp

เซิร์ฟเวอร์ที่ทำงานปกติพิมพ์ rivalize-mcp-server connected via stdio ไปที่ stderr และรออินพุต (กด Ctrl+C เพื่อหยุด) สิ่งอื่นใดคือสาเหตุที่ไคลเอนต์ของคุณไม่สามารถเชื่อมต่อได้

ทุกการเรียกส่งคืน 401

คีย์ถูกปฏิเสธโดยเซิร์ฟเวอร์ที่ส่งไป และข้อผิดพลาดระบุชื่อเซิร์ฟเวอร์นั้น ตรวจสอบว่าคีย์ยังไม่ถูกเพิกถอน และ RIVALIZE_API_URL ไม่ได้ตั้งค่าเว้นแต่คีย์ออกโดยเซิร์ฟเวอร์ Rivalize อื่น

เครื่องมือบอกว่าต้องใช้แผนที่สูงกว่า

การอ่านพร้อมใช้งานในทุกแผน ความสามารถบางอย่าง เช่น แบทเทิลการ์ดและประวัติไทม์ไลน์หรือแลนด์สเคปเต็มรูปแบบ ต้องใช้แผนที่สูงกว่า; ข้อผิดพลาดระบุว่าแผนใดและลิงก์ไปยัง rivalize.ai/pricing

Docker

พื้นที่เก็บข้อมูลรวม Dockerfile ที่สร้างเซิร์ฟเวอร์ stdio เดียวกันบน Node 22 และรันเป็นผู้ใช้ที่ไม่ใช่ root

docker build -t rivalize-mcp .

{
  "mcpServers": {
    "rivalize": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RIVALIZE_API_KEY", "rivalize-mcp"],
      "env": { "RIVALIZE_API_KEY": "rk_live_..." }
    }
  }
}

รันคอนเทนเนอร์ด้วย -i และไม่มี TTY เนื่องจาก MCP ใช้ stdin และ stdout -e RIVALIZE_API_KEY ที่ไม่มีค่าส่งคีย์ผ่านจากสภาพแวดล้อมของไคลเอนต์ ดังนั้นจึงไม่ปรากฏบนบรรทัดคำสั่ง docker run เพิ่ม -e RIVALIZE_API_URL หรือ -e RIVALIZE_MCP_ALLOW_WRITES ในลักษณะเดียวกันหากคุณต้องการ

นโยบายความเป็นส่วนตัว

เซิร์ฟเวอร์นี้เป็นไคลเอนต์แบบบางสำหรับ API ของ Rivalize

• สิ่งที่ส่งไป และส่งไปที่ใด การเรียกใช้เครื่องมือแต่ละครั้งจะกลายเป็นคำขอ HTTPS ไปยัง Rivalize API ที่ https://rivalize.ai หรือ origin ที่คุณตั้งค่าใน RIVALIZE_API_URL คำขอจะนำคีย์ API ของคุณเป็น Bearer token, ค่า User-Agent ของ rivalize-mcp/<version> และอาร์กิวเมนต์ของเครื่องมือ: ตัวอย่างเช่น domain ของบริษัท, คำค้นหา, โปรเจกต์, รายงาน หรือ id ของคู่แข่ง และเมื่อเปิดใช้งานการเขียน จะรวม URL ของคู่แข่งที่คุณเพิ่มด้วย หากคุณตั้งค่า HTTPS_PROXY หรือ HTTP_PROXY คำขอจะผ่าน proxy นั้น ไม่มีการส่งข้อมูล ไปที่อื่นใด
• สิ่งที่ไม่ได้ส่ง ไม่มี telemetry, analytics หรือ crash reports ไม่มีการอ่าน ไฟล์บนเครื่องของคุณ บทสนทนาของคุณ หรือผลลัพธ์ของเครื่องมืออื่น ๆ มองเห็นเฉพาะอาร์กิวเมนต์ที่ MCP client ของคุณส่งให้กับเครื่องมือของมันเองเท่านั้น
• สิ่งที่จัดเก็บในเครื่อง ไม่มีอะไร ไม่มีการเขียนไฟล์ ไม่มี cache และไม่มีการเก็บ สถานะระหว่างการรัน คีย์ของคุณอยู่ใน configuration ของ MCP client ไม่ใช่ในเซิร์ฟเวอร์นี้ ข้อความวินิจฉัยจะไปที่ stderr ซึ่ง MCP client ของคุณอาจ บันทึกไว้ ข้อความเหล่านั้นจะไม่รวมคีย์ API ของคุณ
• Rivalize ทำอะไรกับคำขอ API จะประมวลผลภายใต้ นโยบายความเป็นส่วนตัวของ Rivalize ที่ rivalize.ai/privacy Rivalize ดำเนินการโดย Downshift LLC ซึ่งเป็นผู้ควบคุมข้อมูลสำหรับข้อมูลนั้น คำถามเกี่ยวกับความเป็นส่วนตัวส่งไปที่ privacy@rivalize.ai

ความปลอดภัย

กรุณารายงานช่องโหว่เป็นการส่วนตัวไปที่ support@rivalize.ai โดยมีคำว่า "security" ในหัวข้ออีเมล ไม่ใช่ใน issue สาธารณะ รวมถึงเวอร์ชันของแพ็กเกจ (npm view @rivalize/mcp version หรือ User-Agent ด้านบน) สิ่งที่คุณทำ และสิ่งที่เกิดขึ้น เราจะยืนยันการรับรายงานและแจ้งความคืบหน้าจนกว่าจะแก้ไขเสร็จ

ปฏิบัติต่อคีย์ API ของคุณเหมือนข้อมูลประจำตัว เก็บไว้ในบล็อก env ของ client หรือ ใน environment ของ shell อย่าเก็บในไฟล์ที่แชร์หรือ commit และเพิกถอน คีย์ที่รั่วไหลภายใต้ Dashboard → Settings → API Keys

การมีส่วนร่วม

ยินดีรับรายงานบั๊กและคำขอฟีเจอร์ที่ github.com/Downshift/rivalize-mcp/issues สำหรับคำถามเกี่ยวกับบัญชีและการเรียกเก็บเงิน ส่งอีเมลไปที่ support@rivalize.ai

เพื่อทำงานบนเซิร์ฟเวอร์ในเครื่อง:

npm ci
npm run typecheck
npm run build      # emits dist/, which the rivalize-mcp bin runs
npm test           # offline: every API call is mocked or served by a local fixture

server.json คือรายการใน MCP Registry การทดสอบจะตรวจสอบกับ schema อย่างเป็นทางการ (vendored ใน schema/) และตรวจสอบว่าชื่อ เวอร์ชัน และแพ็กเกจตรงกับ package.json

บันทึกการเปลี่ยนแปลง

0.3.2

• list_competitors ตอนนี้บอกผู้ช่วยของคุณถึงวิธีเลือกคู่แข่งอันดับต้น: โดยอันดับของคู่แข่งบน Brief ของคุณ (brief.standing) เมื่อ API ส่งคืน มิฉะนั้นจะใช้ momentum_score threat_level ถูกอธิบายตามความเป็นจริง คือช่วงของคะแนน momentum และไม่ถูกเสนอเป็นการจัดอันดับอีกต่อไป
• เมื่ออันดับของแถวยังอยู่ระหว่างการอ่าน (brief.state คือ deferred) list_competitors จะขอหน้าเดียวกันอีกครั้ง สูงสุด 4 ครั้ง ห่างกัน 1.5 วินาที สำหรับ API ที่ไม่ส่งคืน brief จะทำหนึ่งคำขอต่อการเรียกใช้ เหมือนเดิม
• ถ้อยคำที่ชัดเจนขึ้นในคำแนะนำ 401 สำหรับเซิร์ฟเวอร์ Rivalize ที่ self-hosted หรือไม่ใช่ production และในคำอธิบายของ add_competitor

0.3.1

• เวอร์ชันที่ประวัติของ repository นี้เริ่มต้น: เครื่องมือแบบอ่านอย่างเดียวสิบสามตัว เครื่องมือเขียน add_competitor ที่เลือกใช้ การตอบสนองที่จำกัดไว้ต่ำกว่า 25,000 ตัวอักษรพร้อมการแบ่งหน้าแบบชัดเจน รองรับ proxy และรายการ MCP Registry ใน server.json

สัญญาอนุญาต

MIT, © 2026 Downshift LLC ดู LICENSE