App-Kit
SEO audit (400 checks), text readability and grammar check, PDF to images, image conversion.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- HIGH
- MEDIUMseo_audit_fast에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.app-kit.dev/mcp"
}
}
}원격 엔드포인트
https://mcp.app-kit.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (10)
🟢text_check(text, lang, layers, response_lang)
Check a text: metrics (filler words, spam, keyword stuffing), readability, stop phrases, grammar. Input: text up to 20000 characters, lang (language of the text) ru or en. Returns passed (blocking thresholds), metrics by layer, verdicts (blocking=false means a recommendation), top_issues (up to 5 main issues) and locations: issue positions (offset/length) in the submitted text. The text is not stored. Rate-limited per day; call quota_status for remaining calls.
입력 스키마
{
"type": "object",
"properties": {
"text": {
"description": "Text to check, up to 20000 characters",
"title": "Text",
"type": "string"
},
"lang": {
"default": "ru",
"description": "Language of the checked text",
"enum": [
"ru",
"en"
],
"title": "Lang",
"type": "string"
},
"layers": {
"anyOf": [
{
"items": {
"enum": [
"metrics",
"readability",
"phrases",
"grammar"
],
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Layers: metrics, readability, phrases, grammar (all by default)",
"title": "Layers"
},
"response_lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Response Lang",
"type": "string"
}
},
"required": [
"text"
],
"title": "text_checkArguments"
}출력 스키마
{
"type": "object",
"properties": {
"passed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the text passed all blocking thresholds",
"title": "Passed"
},
"lang": {
"title": "Lang",
"type": "string"
},
"layers": {
"additionalProperties": {
"additionalProperties": true,
"type": "object"
},
"description": "Metrics by layer (numbers and statuses only, no text fragments)",
"title": "Layers",
"type": "object"
},
"verdicts": {
"items": {
"$ref": "#/$defs/Verdict"
},
"title": "Verdicts",
"type": "array"
},
"top_issues": {
"description": "Up to 5 main issues, blocking failures first",
"items": {
"$ref": "#/$defs/Verdict"
},
"title": "Top Issues",
"type": "array"
},
"locations": {
"description": "Up to 10 issue positions (grammar, stop phrases): offset/length in the submitted text",
"items": {
"$ref": "#/$defs/IssueLocation"
},
"title": "Locations",
"type": "array"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"passed",
"lang",
"layers",
"verdicts",
"top_issues",
"quota"
],
"$defs": {
"IssueLocation": {
"description": "Position of an issue in the submitted text: coordinates only, no text fragments.",
"properties": {
"layer": {
"enum": [
"grammar",
"phrases"
],
"title": "Layer",
"type": "string"
},
"offset": {
"description": "Offset in characters from the start of the text",
"title": "Offset",
"type": "integer"
},
"length": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Length of the fragment in characters (if known)",
"title": "Length"
},
"rule": {
"description": "grammar: LanguageTool rule id; phrases: stop phrase from the App-Kit list",
"title": "Rule",
"type": "string"
}
},
"required": [
"layer",
"offset",
"rule"
],
"title": "IssueLocation",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
},
"Verdict": {
"properties": {
"metric": {
"title": "Metric",
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Label"
},
"value": {
"anyOf": [
{
"type": "number"
},
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Value"
},
"threshold": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Threshold"
},
"result": {
"description": "pass | fail | unknown",
"title": "Result",
"type": "string"
},
"blocking": {
"default": false,
"title": "Blocking",
"type": "boolean"
}
},
"required": [
"metric",
"result"
],
"title": "Verdict",
"type": "object"
}
},
"title": "TextCheckOut"
}🟢seo_audit_fast(url, lang)
Quick SEO audit of a public website (up to 10 pages): score 0-100 by check group, failed checks, top 5 losses. The site root is audited: URL path and query are dropped (https://example.com/page?x=1 -> https://example.com/). Waits up to 60 s for the result, sending progress. If not done by then, returns status=running and a handle: call seo_audit_status(handle) every poll_after_s seconds while status=running. Rate-limited per day; call quota_status for remaining calls. One domain: up to 5 audits per day.
입력 스키마
{
"type": "object",
"properties": {
"url": {
"description": "Public website URL, e.g. https://example.com (the site root is audited)",
"title": "Url",
"type": "string"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"required": [
"url"
],
"title": "seo_audit_fastArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"enum": [
"done",
"running",
"failed"
],
"title": "Status",
"type": "string"
},
"mode": {
"enum": [
"fast",
"full"
],
"title": "Mode",
"type": "string"
},
"stage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "queued → crawl → analyze → report → done",
"title": "Stage"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Domain"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to seo_audit_status while status=running",
"title": "Handle"
},
"poll_after_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Poll After S"
},
"score": {
"anyOf": [
{
"$ref": "#/$defs/Score"
},
{
"type": "null"
}
],
"default": null
},
"checks": {
"description": "Failed checks only (up to 100)",
"items": {
"$ref": "#/$defs/FailedCheck"
},
"title": "Checks",
"type": "array"
},
"checks_failed_total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Checks Failed Total"
},
"top_losses": {
"description": "Up to 5 checks with the largest score loss",
"items": {
"$ref": "#/$defs/Loss"
},
"title": "Top Losses",
"type": "array"
},
"report_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "PDF report link; not provided by this server (null)",
"title": "Report Link"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"mode",
"quota"
],
"$defs": {
"FailedCheck": {
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"group": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Group"
},
"priority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Priority"
},
"status": {
"title": "Status",
"type": "string"
}
},
"required": [
"id",
"status"
],
"title": "FailedCheck",
"type": "object"
},
"Loss": {
"properties": {
"check_id": {
"title": "Check Id",
"type": "string"
},
"group": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Group"
},
"priority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Priority"
},
"lost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Score weight lost on this check",
"title": "Lost"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Check name from the App-Kit check list (not page text)",
"title": "Title"
}
},
"required": [
"check_id"
],
"title": "Loss",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
},
"Score": {
"properties": {
"overall": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Overall"
},
"groups": {
"additionalProperties": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": "Score 0-100 by check group",
"title": "Groups",
"type": "object"
}
},
"required": [
"overall",
"groups"
],
"title": "Score",
"type": "object"
}
},
"title": "SeoAuditOut"
}🟢seo_audit_status(handle, lang)
Status and result of an SEO audit by the handle from seo_audit_fast. Does not consume quota. While status=running, call again after poll_after_s seconds. A handle is valid for 60 min and only for the caller who started the audit.
입력 스키마
{
"type": "object",
"properties": {
"handle": {
"description": "handle returned by an SEO audit tool",
"title": "Handle",
"type": "string"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"required": [
"handle"
],
"title": "seo_audit_statusArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"enum": [
"done",
"running",
"failed"
],
"title": "Status",
"type": "string"
},
"mode": {
"enum": [
"fast",
"full"
],
"title": "Mode",
"type": "string"
},
"stage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "queued → crawl → analyze → report → done",
"title": "Stage"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Domain"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to seo_audit_status while status=running",
"title": "Handle"
},
"poll_after_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Poll After S"
},
"score": {
"anyOf": [
{
"$ref": "#/$defs/Score"
},
{
"type": "null"
}
],
"default": null
},
"checks": {
"description": "Failed checks only (up to 100)",
"items": {
"$ref": "#/$defs/FailedCheck"
},
"title": "Checks",
"type": "array"
},
"checks_failed_total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Checks Failed Total"
},
"top_losses": {
"description": "Up to 5 checks with the largest score loss",
"items": {
"$ref": "#/$defs/Loss"
},
"title": "Top Losses",
"type": "array"
},
"report_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "PDF report link; not provided by this server (null)",
"title": "Report Link"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"mode",
"quota"
],
"$defs": {
"FailedCheck": {
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"group": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Group"
},
"priority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Priority"
},
"status": {
"title": "Status",
"type": "string"
}
},
"required": [
"id",
"status"
],
"title": "FailedCheck",
"type": "object"
},
"Loss": {
"properties": {
"check_id": {
"title": "Check Id",
"type": "string"
},
"group": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Group"
},
"priority": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Priority"
},
"lost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Score weight lost on this check",
"title": "Lost"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Check name from the App-Kit check list (not page text)",
"title": "Title"
}
},
"required": [
"check_id"
],
"title": "Loss",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
},
"Score": {
"properties": {
"overall": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Overall"
},
"groups": {
"additionalProperties": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": "Score 0-100 by check group",
"title": "Groups",
"type": "object"
}
},
"required": [
"overall",
"groups"
],
"title": "Score",
"type": "object"
}
},
"title": "SeoAuditOut"
}🟢pdf_to_images(source_url, upload_id, data_base64, format, dpi, ...)
Convert an existing PDF to images (one file per page): format png/jpeg/webp, dpi 72-300, first_page/last_page. PDF up to 20 MB and up to 20 pages. Input: exactly one of source_url (public URL, the server downloads it), upload_id (create_upload, then PUT) or data_base64 (up to 512 KB). Output: download links (resource_link, valid for 10 min; deleted once all files of the job are downloaded) and a preview of the first image. If not done within 60 s, returns status=running and a handle: call conversion_status(handle). Rate-limited per day; call quota_status for remaining calls.
입력 스키마
{
"type": "object",
"properties": {
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public file URL (the server downloads it); preferred for hosted clients",
"title": "Source Url"
},
"upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "upload_id from create_upload (after the file PUT)",
"title": "Upload Id"
},
"data_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "File as base64, only for small files (up to 512 KB)",
"title": "Data Base64"
},
"format": {
"default": "png",
"description": "Page image format",
"enum": [
"png",
"jpeg",
"webp"
],
"title": "Format",
"type": "string"
},
"dpi": {
"default": 150,
"description": "Resolution 72-300 dpi",
"maximum": 300,
"minimum": 72,
"title": "Dpi",
"type": "integer"
},
"first_page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "First page (from 1)",
"title": "First Page"
},
"last_page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Last page",
"title": "Last Page"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"title": "pdf_to_imagesArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"enum": [
"done",
"running"
],
"title": "Status",
"type": "string"
},
"tool": {
"title": "Tool",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to conversion_status while status=running",
"title": "Handle"
},
"poll_after_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Poll After S"
},
"pages": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of rendered pages (pdf_to_images only)",
"title": "Pages"
},
"files": {
"items": {
"$ref": "#/$defs/OutFile"
},
"title": "Files",
"type": "array"
},
"bytes_out": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes Out"
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When the links expire (UTC)",
"title": "Expires At"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"tool",
"quota"
],
"$defs": {
"OutFile": {
"properties": {
"n": {
"description": "Output number from 1 (page or file)",
"title": "N",
"type": "integer"
},
"url": {
"description": "Download link (valid until expires_at; files are deleted after download)",
"title": "Url",
"type": "string"
},
"content_type": {
"title": "Content Type",
"type": "string"
},
"filename": {
"title": "Filename",
"type": "string"
},
"bytes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes"
}
},
"required": [
"n",
"url",
"content_type",
"filename"
],
"title": "OutFile",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
}
},
"title": "ConversionOut"
}🟢images_to_pdf(source_urls, upload_ids, page_size, lang)
Combine existing images into one PDF (one image per page), page_size A4/Letter or the image size. Input: source_urls[] or upload_ids[], up to 20 files, each up to 20 MB. Output: download links (resource_link, valid for 10 min; deleted once all files of the job are downloaded) and a preview of the first image. If not done within 60 s, returns status=running and a handle: call conversion_status(handle). Rate-limited per day; call quota_status for remaining calls.
입력 스키마
{
"type": "object",
"properties": {
"source_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Public image URLs, in page order",
"title": "Source Urls"
},
"upload_ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Image upload_ids from create_upload, in page order",
"title": "Upload Ids"
},
"page_size": {
"anyOf": [
{
"enum": [
"A4",
"Letter"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Page size; if omitted, the image size is used",
"title": "Page Size"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"title": "images_to_pdfArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"enum": [
"done",
"running"
],
"title": "Status",
"type": "string"
},
"tool": {
"title": "Tool",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to conversion_status while status=running",
"title": "Handle"
},
"poll_after_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Poll After S"
},
"pages": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of rendered pages (pdf_to_images only)",
"title": "Pages"
},
"files": {
"items": {
"$ref": "#/$defs/OutFile"
},
"title": "Files",
"type": "array"
},
"bytes_out": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes Out"
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When the links expire (UTC)",
"title": "Expires At"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"tool",
"quota"
],
"$defs": {
"OutFile": {
"properties": {
"n": {
"description": "Output number from 1 (page or file)",
"title": "N",
"type": "integer"
},
"url": {
"description": "Download link (valid until expires_at; files are deleted after download)",
"title": "Url",
"type": "string"
},
"content_type": {
"title": "Content Type",
"type": "string"
},
"filename": {
"title": "Filename",
"type": "string"
},
"bytes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes"
}
},
"required": [
"n",
"url",
"content_type",
"filename"
],
"title": "OutFile",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
}
},
"title": "ConversionOut"
}🟢image_convert(target_format, source_url, upload_id, data_base64, quality, ...)
Convert an existing image to another format: target_format png/jpeg/webp/bmp/tiff/gif, quality 1-100, max_dim (downscale the long side). File up to 20 MB. For avif and maximum compression use image_compress. Input: exactly one of source_url (public URL, the server downloads it), upload_id (create_upload, then PUT) or data_base64 (up to 512 KB). Output: download links (resource_link, valid for 10 min; deleted once all files of the job are downloaded) and a preview of the first image. If not done within 60 s, returns status=running and a handle: call conversion_status(handle). Rate-limited per day; call quota_status for remaining calls.
입력 스키마
{
"type": "object",
"properties": {
"target_format": {
"description": "Target format",
"enum": [
"png",
"jpeg",
"webp",
"bmp",
"tiff",
"gif"
],
"title": "Target Format",
"type": "string"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public file URL (the server downloads it); preferred for hosted clients",
"title": "Source Url"
},
"upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "upload_id from create_upload (after the file PUT)",
"title": "Upload Id"
},
"data_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "File as base64, only for small files (up to 512 KB)",
"title": "Data Base64"
},
"quality": {
"default": 90,
"description": "Quality 1-100 (jpeg/webp)",
"maximum": 100,
"minimum": 1,
"title": "Quality",
"type": "integer"
},
"max_dim": {
"anyOf": [
{
"maximum": 10000,
"minimum": 16,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Downscale the long side to N px",
"title": "Max Dim"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"required": [
"target_format"
],
"title": "image_convertArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"enum": [
"done",
"running"
],
"title": "Status",
"type": "string"
},
"tool": {
"title": "Tool",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to conversion_status while status=running",
"title": "Handle"
},
"poll_after_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Poll After S"
},
"pages": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of rendered pages (pdf_to_images only)",
"title": "Pages"
},
"files": {
"items": {
"$ref": "#/$defs/OutFile"
},
"title": "Files",
"type": "array"
},
"bytes_out": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes Out"
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When the links expire (UTC)",
"title": "Expires At"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"tool",
"quota"
],
"$defs": {
"OutFile": {
"properties": {
"n": {
"description": "Output number from 1 (page or file)",
"title": "N",
"type": "integer"
},
"url": {
"description": "Download link (valid until expires_at; files are deleted after download)",
"title": "Url",
"type": "string"
},
"content_type": {
"title": "Content Type",
"type": "string"
},
"filename": {
"title": "Filename",
"type": "string"
},
"bytes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes"
}
},
"required": [
"n",
"url",
"content_type",
"filename"
],
"title": "OutFile",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
}
},
"title": "ConversionOut"
}🟢conversion_status(handle, lang)
Status and result of a conversion by the handle from pdf_to_images / images_to_pdf / image_convert. Does not consume quota. While status=running, call again after poll_after_s seconds. A handle is valid for 1 hour and only for the caller who started the conversion.
입력 스키마
{
"type": "object",
"properties": {
"handle": {
"description": "handle from pdf_to_images / images_to_pdf / image_convert",
"title": "Handle",
"type": "string"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"required": [
"handle"
],
"title": "conversion_statusArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"enum": [
"done",
"running"
],
"title": "Status",
"type": "string"
},
"tool": {
"title": "Tool",
"type": "string"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to conversion_status while status=running",
"title": "Handle"
},
"poll_after_s": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Poll After S"
},
"pages": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of rendered pages (pdf_to_images only)",
"title": "Pages"
},
"files": {
"items": {
"$ref": "#/$defs/OutFile"
},
"title": "Files",
"type": "array"
},
"bytes_out": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes Out"
},
"expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "When the links expire (UTC)",
"title": "Expires At"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"tool",
"quota"
],
"$defs": {
"OutFile": {
"properties": {
"n": {
"description": "Output number from 1 (page or file)",
"title": "N",
"type": "integer"
},
"url": {
"description": "Download link (valid until expires_at; files are deleted after download)",
"title": "Url",
"type": "string"
},
"content_type": {
"title": "Content Type",
"type": "string"
},
"filename": {
"title": "Filename",
"type": "string"
},
"bytes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Bytes"
}
},
"required": [
"n",
"url",
"content_type",
"filename"
],
"title": "OutFile",
"type": "object"
},
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
}
},
"title": "ConversionOut"
}🟢image_compress(source_url, upload_id, data_base64, format, quality, ...)
Compress an existing image to WebP or AVIF: quality 1-100, width/height (downscale), preset (photo/picture/drawing/icon/text), lossless. Returns a result link (valid up to 5 min), original and new size, compression ratio. File up to 20 MB. Input: exactly one of source_url (public URL, the server downloads it), upload_id (create_upload, then PUT) or data_base64 (up to 512 KB). Rate-limited per day; call quota_status for remaining calls.
입력 스키마
{
"type": "object",
"properties": {
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Public file URL (the server downloads it); preferred for hosted clients",
"title": "Source Url"
},
"upload_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "upload_id from create_upload (after the file PUT)",
"title": "Upload Id"
},
"data_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "File as base64, only for small files (up to 512 KB)",
"title": "Data Base64"
},
"format": {
"default": "webp",
"description": "Output format",
"enum": [
"webp",
"avif"
],
"title": "Format",
"type": "string"
},
"quality": {
"anyOf": [
{
"maximum": 100,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Quality 1-100",
"title": "Quality"
},
"width": {
"anyOf": [
{
"maximum": 16384,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Downscale to this width, px",
"title": "Width"
},
"height": {
"anyOf": [
{
"maximum": 16384,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Downscale to this height, px",
"title": "Height"
},
"preset": {
"anyOf": [
{
"enum": [
"default",
"photo",
"picture",
"drawing",
"icon",
"text"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Preset"
},
"lossless": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Lossless compression",
"title": "Lossless"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"title": "image_compressArguments"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"const": "done",
"title": "Status",
"type": "string"
},
"url": {
"description": "Result link (valid until expires_at)",
"title": "Url",
"type": "string"
},
"content_type": {
"title": "Content Type",
"type": "string"
},
"original_size": {
"title": "Original Size",
"type": "integer"
},
"converted_size": {
"title": "Converted Size",
"type": "integer"
},
"compression_ratio": {
"title": "Compression Ratio",
"type": "number"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Width"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Height"
},
"expires_at": {
"title": "Expires At",
"type": "string"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"status",
"url",
"content_type",
"original_size",
"converted_size",
"compression_ratio",
"expires_at",
"quota"
],
"$defs": {
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
}
},
"title": "CompressOut"
}🟡create_upload(filename, size, content_type, lang)
Create a one-time upload link for a local file (for clients with local file access, e.g. Claude Code, Cursor). Returns upload_id, put_url and a curl command: upload the file with a single PUT (up to 20 MB, within 10 min), then pass upload_id to a file tool. One upload_id serves one call. For a file at a public URL, pass source_url directly instead. Rate-limited per day; call quota_status for remaining calls.
입력 스키마
{
"type": "object",
"properties": {
"filename": {
"description": "File name, e.g. report.pdf",
"maxLength": 200,
"title": "Filename",
"type": "string"
},
"size": {
"description": "File size in bytes",
"exclusiveMinimum": 0,
"title": "Size",
"type": "integer"
},
"content_type": {
"default": "application/octet-stream",
"description": "MIME type, e.g. application/pdf or image/png",
"title": "Content Type",
"type": "string"
},
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"required": [
"filename",
"size"
],
"title": "create_uploadArguments"
}출력 스키마
{
"type": "object",
"properties": {
"upload_id": {
"description": "Pass to pdf_to_images / images_to_pdf / image_convert / image_compress",
"title": "Upload Id",
"type": "string"
},
"put_url": {
"description": "Where to upload the file with a single PUT (body: raw file bytes)",
"title": "Put Url",
"type": "string"
},
"expires_at": {
"description": "Deadline to upload and use the file (UTC)",
"title": "Expires At",
"type": "string"
},
"max_bytes": {
"title": "Max Bytes",
"type": "integer"
},
"curl": {
"description": "Ready-to-run upload command",
"title": "Curl",
"type": "string"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"upload_id",
"put_url",
"expires_at",
"max_bytes",
"curl",
"quota"
],
"$defs": {
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
}
},
"title": "CreateUploadOut"
}🟢quota_status(lang)
Show the current access tier and the remaining calls for each tool. Tiers: L0 anonymous (shared per platform for Claude and ChatGPT), L1 personal token, L2 App-Kit account (OAuth). Does not consume quota.
입력 스키마
{
"type": "object",
"properties": {
"lang": {
"default": "en",
"description": "Language for human-readable messages; pass the user's language",
"enum": [
"en",
"ru"
],
"title": "Lang",
"type": "string"
}
},
"title": "quota_statusArguments"
}출력 스키마
{
"type": "object",
"properties": {
"tier": {
"title": "Tier",
"type": "string"
},
"tools": {
"items": {
"$ref": "#/$defs/ToolQuota"
},
"title": "Tools",
"type": "array"
},
"upgrade_url": {
"title": "Upgrade Url",
"type": "string"
},
"quota": {
"$ref": "#/$defs/Quota"
}
},
"required": [
"tier",
"tools",
"upgrade_url",
"quota"
],
"$defs": {
"Quota": {
"properties": {
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Calls left in the narrowest window; null means no limit",
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When that window resets (UTC, ISO 8601)",
"title": "Reset At"
},
"tier": {
"description": "Access tier: L0 anonymous, L1 personal token, L2 App-Kit account (OAuth), L3 App-Kit API key",
"title": "Tier",
"type": "string"
},
"upgrade_url": {
"description": "Informational page about App-Kit usage tiers",
"title": "Upgrade Url",
"type": "string"
},
"domain_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Audits of this domain left today (seo-audit only); null if not applicable",
"title": "Domain Remaining"
}
},
"required": [
"remaining",
"reset_at",
"tier",
"upgrade_url"
],
"title": "Quota",
"type": "object"
},
"ToolQuota": {
"properties": {
"tool": {
"title": "Tool",
"type": "string"
},
"available": {
"description": "Whether the tool is available at the current tier",
"title": "Available",
"type": "boolean"
},
"remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Remaining"
},
"reset_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reset At"
},
"limits": {
"additionalProperties": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"description": "Tier limits: per_hour, per_day, global_per_day, domain_per_day",
"title": "Limits",
"type": "object"
}
},
"required": [
"tool",
"available",
"remaining",
"reset_at",
"limits"
],
"title": "ToolQuota",
"type": "object"
}
},
"title": "QuotaStatusOut"
}커뮤니티
증거