CitationEasy dành cho trợ lý và agent AI

Tại sao nên gọi API thay vì tự viết trích dẫn

Định dạng trích dẫn trông giống như một bài toán sinh văn bản nhưng không phải vậy. Mỗi kiểu mã hóa hàng trăm quy tắc về đảo tên tác giả, chữ viết tắt, viết hoa tiêu đề, dấu câu của vật chứa, cách ghi ấn bản và vị trí ngày tháng, và chúng khác nhau theo những cách rất dễ nhớ sai một cách tinh vi. CitationEasy chạy citeproc-js dựa trên các định nghĩa Citation Style Language chính thức — cùng công cụ mà Zotero và Mendeley sử dụng — nên đầu ra là tất định và khớp với những gì hệ thống nộp bài của một tạp chí mong đợi. Siêu dữ liệu đến từ Crossref, Open Library và PubMed; không có gì được bịa ra, và một trường bị thiếu ở nguồn dữ liệu gốc sẽ vẫn thiếu thay vì được điền bằng một phỏng đoán hợp lý.

Tạo một trích dẫn

curl -s https://www.citationeasy.com/api/v1/cite \
  -H 'Content-Type: application/json' \
  -d '{"input":"10.1038/nature12373","style":"apa","inText":true}'

{
  "style": { "requested": "apa", "slug": "apa", "name": "American Psychological Association (APA) 7th edition" },
  "language": "en-US",
  "results": [
    {
      "input": "10.1038/nature12373",
      "citation": "…formatted reference…",
      "inText": "(Author, 2013)",
      "entry": { "…resolved CSL metadata…": "" }
    }
  ]
}

Gửi inputs thay vì input để xử lý tối đa 10 nguồn trong một lần gọi, hoặc entry với siêu dữ liệu CSL-JSON bạn đã có sẵn để bỏ qua hoàn toàn bước tra cứu. Thêm note: true để lấy dạng chú thích chân trang. Lỗi của từng nguồn được trả về riêng cho nguồn đó, vì vậy một lô không bao giờ thất bại toàn bộ.

Kết nối qua MCP

Điểm cuối Model Context Protocol tại /api/mcp giao tiếp bằng JSON-RPC 2.0 qua streamable HTTP và không cần thông tin xác thực.

# Claude Code
claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp

# Any MCP client config
{
  "mcpServers": {
    "citationeasy": { "type": "http", "url": "https://www.citationeasy.com/api/mcp" }
  }
}

Điểm cuối

Tệp khám phá

/llms.txt

Chỉ mục được tuyển chọn của trang web, viết dành cho mô hình ngôn ngữ.

/llms-full.txt

Mọi trang mà trang web xuất bản, được nhóm theo loại, mỗi trang một dòng.

/openapi.json

Mô tả OpenAPI 3.1 cho toàn bộ API công khai.

/api/mcp

Điểm cuối MCP (streamable HTTP). Gửi GET trong trình duyệt để xem mô tả.

/.well-known/mcp.json

Tài liệu khám phá MCP dành cho agent dò tìm một tên miền.

/.well-known/ai-plugin.json

Tệp khai báo plugin cũ, dành cho các framework vẫn còn tìm kiếm nó.

/md/{any path}

Chế độ xem markdown của bất kỳ trang nào trên trang web.

/sitemap.xml

Mọi URL có thể được lập chỉ mục.

Danh mục gồm những gì

Mọi trang dưới đây đều có thể truy cập dưới dạng HTML, dưới dạng markdown tại /md/, và dưới dạng một mục có cấu trúc từ /api/v1/pages.

• 10.834 kiểu trích dẫn, mỗi kiểu có ví dụ thực tế được tạo ra từ chính định nghĩa CSL của nó
• 250 công cụ trình duyệt miễn phí
• 125 hướng dẫn học tập
• 1.290 trang cách trích dẫn
• 105 so sánh kiểu
• 21 công cụ chuyển đổi
• 32 lĩnh vực học thuật
• 30 trang trung tâm kiểu chính với đầy đủ quy tắc định dạng

Câu hỏi Thường gặp

API CitationEasy có miễn phí không, và tôi có cần khóa API không?

Miễn phí và không cần khóa API. Mọi điểm cuối trong /api/v1 đều không cần xác thực và mở CORS, vì vậy bạn có thể gọi từ trình duyệt, notebook hoặc agent mà không cần đăng ký. Chúng tôi không đặt giới hạn tốc độ riêng, nhưng các tra cứu mã định danh được chuyển tiếp đến Crossref, Open Library và PubMed, những bên áp dụng giới hạn sử dụng hợp lý của riêng họ — hãy gộp lô bằng `inputs` thay vì gửi nhiều yêu cầu song song.

Trích dẫn có được tạo bởi mô hình ngôn ngữ không?

Không. Việc định dạng chạy citeproc-js dựa trên các định nghĩa Citation Style Language chính thức, cùng công cụ mà các trình quản lý tài liệu tham khảo sử dụng. Cùng một đầu vào và kiểu luôn tạo ra cùng một chuỗi kết quả. Siêu dữ liệu thư mục đến từ Crossref (DOI), Open Library (ISBN) và PubMed (PMID) — CitationEasy không bịa ra các trường, vì vậy bất cứ điều gì thiếu ở nguồn gốc sẽ thiếu trong đầu ra thay vì bị đoán ra.

Làm thế nào để kết nối một agent với CitationEasy qua MCP?

Trỏ bất kỳ client Model Context Protocol nào đến https://www.citationeasy.com/api/mcp bằng giao vận streamable HTTP. Không cần thông tin xác thực. Trong Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. Máy chủ này cung cấp các công cụ để tạo trích dẫn, tìm kiếm 10.834 kiểu, hướng dẫn theo loại nguồn, tìm kiếm trang web và đọc bất kỳ trang nào dưới dạng markdown.

API có thể tạo ra những kiểu trích dẫn nào?

Tất cả 10.834 kiểu trong kho lưu trữ Citation Style Language, bao gồm APA 7, MLA 9, cả hai hệ thống Chicago, Harvard, Vancouver, IEEE, AMA và hàng nghìn kiểu tạp chí riêng lẻ. Truyền slug của kiểu vào trường `style`. Các slug thân thiện như "chicago" và "harvard" sẽ phân giải đến đúng biến thể CSL, và /api/v1/styles?q= tìm ra phần còn lại.

llms.txt là gì và của CitationEasy nằm ở đâu?

llms.txt là một chỉ mục dạng văn bản thuần của một trang web, viết dành cho mô hình ngôn ngữ thay vì trình duyệt. Của CitationEasy nằm tại /llms.txt; phiên bản đầy đủ liệt kê mọi trang của trang web nằm tại /llms-full.txt.

Tôi có thể đọc các trang của CitationEasy dưới dạng markdown thay vì HTML không?

Có. Thêm tiền tố /md/ vào bất kỳ đường dẫn trang nào — ví dụ /md/citation-style/apa hoặc /md/tools/word-counter. Các trang dựa trên dữ liệu trả về toàn bộ nội dung, bao gồm các ví dụ định dạng thực tế được tạo ra từ chính định nghĩa CSL của mỗi kiểu. Các trang văn xuôi viết tay (hướng dẫn, bảng tra cứu nhanh) trả về một thẻ tóm tắt cùng URL HTML chính thức, vì nội dung của chúng nằm ngay trong trang.

Tôi có thể sử dụng kết quả của CitationEasy trong sản phẩm của riêng mình không?

Có. Một trích dẫn đã định dạng là một sự thật về một nguồn; hãy sử dụng nó tự do. Bản thân các định nghĩa kiểu CSL đến từ dự án Citation Style Language theo giấy phép CC BY-SA 3.0. Ghi công cho CitationEasy được hoan nghênh nhưng không bắt buộc.