Skip to main content
Glama

LeoWorks Review & Lead Data Tools (via Apify MCP)

leoworks/naver-blog-brand-monitor

leoworks--naver-blog-brand-monitor
Destructive

This tool calls the Actor "leoworks/naver-blog-brand-monitor" and retrieves its output results. Actor description: Naver Blog scraper (네이버 블로그): posts by keyword, sponsored post detection (체험단/협찬), sentiment, brand mentions — Korean social listening. Use for blog posts; for shop ranks use leoworks/naver-shopping-rank-tracker. queries = Korean keywords. No login, ~6 min/1,000 posts, pay per post.

Input Schema

NameRequiredDescriptionDefault
sortNoMost recent posts first (good for monitoring) or Naver relevance order. Example values: "recent"recent
judgeNoWhich judgments to add (charged as post-judged per post when any is on): sponsored (체험단/협찬 vs 내돈내산), sentiment, brandMention. Example values: {"sponsored":true,"sentiment":true,"brandMention":true}
queriesYes**REQUIRED** Naver Blog search queries — usually your brand or product name in Korean (e.g. 라운드랩 선크림, 다이슨 에어랩 후기). Example values: ["라운드랩 선크림"]
dateFromNoOnly posts published on or after this date (YYYY-MM-DD).
waitSecsNoMax seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget.
ncpApiKeyNoOptional secret key paired with the key ID above.
brandNamesNoBrands whose mention you want checked in every post (Korean or English, e.g. 라운드랩, Round Lab). Up to 10. Example values: ["라운드랩"]
healthCheckNoInternal: fail the run when results look degraded (used by the developer's scheduled checks).
ncpApiKeyIdNoOptional. Use your own NAVER Cloud (NCP) NAVER API Hub key for post discovery instead of web search — steadier for large daily volumes. See README.
maxConcurrencyNoPosts processed in parallel. Example values: 10
includeFullTextNoAdd the full post text to each row (larger output).
maxPostsPerQueryNoUp to 1,000 posts per query. The form starts at 8 for a quick, low-cost first run (default when omitted via API: 50). Example values: 8
proxyConfigurationNoDefault Apify datacenter proxy works for most users. Example values: {"useApifyProxy":true}
residentialFallbackNoRetry failing requests through Korean residential proxy. Example values: true

Output Schema

NameRequiredDescriptionDefault
tipNoAdvisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key
runIdYesActor run ID
statsNoRun statistics
statusYesRun status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
actorIdYesStable Apify Actor ID from the run record
summaryYesPast-tense summary of the run state
exitCodeNoActor process exit code; populated for terminal states (especially FAILED)
nextStepYesOne primary follow-up action with identifiers interpolated
storagesYesDataset and key-value store metadata, keyed by alias. "default" is always the primary entry.
actorNameNo"username/actor-name"
startedAtNoISO timestamp when the run started
finishedAtNoISO timestamp when the run finished (terminal states only)
statusMessageNoPass-through from Apify run.statusMessage
apifyConsoleUrlNoPersonalized Apify Console link to the run; present only for Console sessions

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / reactions / properties / impressive
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / properties
      Added value: +{
      +  "text": {
      +    "type": "string"
      +  },
      +  "type": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / type
      Added value: +"object"
  2. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "blogId": {
      +      "type": "string"
      +    },
      +    "blogName": {
      +      "type": "string"
      +    },
      +    "brandMentions": {
      +      "items": {
      +        "properties": {
      +          "brand": {
      +            "type": "string"
      +          },
      +          "mentioned": {
      +            "type": "boolean"
      +          },
      +          "method": {
      +            "type": "string"
      +          },
      +          "probability": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "commentCount": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "likeCount": {
      +      "type": "number"
      +    },
      +    "nickName": {
      +      "type": "string"
      +    },
      +    "publishedAt": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "reactions": {
      +      "properties": {
      +        "like": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "sentiment": {
      +      "properties": {
      +        "confidence": {
      +          "type": "number"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "snippet": {
      +      "type": "string"
      +    },
      +    "sponsored": {
      +      "properties": {
      +        "affiliate": {
      +          "type": "boolean"
      +        },
      +        "affiliateEvidence": {
      +          "items": {
      +            "properties": {
      +              "source": {
      +                "type": "string"
      +              },
      +              "type": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "evidence": {
      +          "items": {},
      +          "type": "array"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "method": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        },
      +        "scores": {
      +          "properties": {
      +            "self_paid": {
      +              "type": "number"
      +            },
      +            "sponsored": {
      +              "type": "number"
      +            },
      +            "unclear": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "blogId": {
      -      "type": "string"
      -    },
      -    "blogName": {
      -      "type": "string"
      -    },
      -    "brandMentions": {
      -      "items": {
      -        "properties": {
      -          "brand": {
      -            "type": "string"
      -          },
      -          "mentioned": {
      -            "type": "boolean"
      -          },
      -          "method": {
      -            "type": "string"
      -          },
      -          "probability": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "commentCount": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "likeCount": {
      -      "type": "number"
      -    },
      -    "nickName": {
      -      "type": "string"
      -    },
      -    "publishedAt": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "reactions": {
      -      "properties": {
      -        "like": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "sentiment": {
      -      "properties": {
      -        "confidence": {
      -          "type": "number"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "snippet": {
      -      "type": "string"
      -    },
      -    "sponsored": {
      -      "properties": {
      -        "affiliate": {
      -          "type": "boolean"
      -        },
      -        "affiliateEvidence": {
      -          "items": {
      -            "properties": {
      -              "source": {
      -                "type": "string"
      -              },
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "evidence": {
      -          "items": {
      -            "properties": {
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "method": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        },
      -        "scores": {
      -          "properties": {
      -            "self_paid": {
      -              "type": "number"
      -            },
      -            "sponsored": {
      -              "type": "number"
      -            },
      -            "unclear": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "title": {
      -      "type": "string"
      -    },
      -    "url": {
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
  4. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  5. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  6. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  7. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  8. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  9. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  10. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  11. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  12. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  13. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  14. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  15. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  16. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  17. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Removed value: -{
      -  "type": "string"
      -}
  18. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  19. Changed3 schema fields changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / reactions
      Added value: +{
      +  "properties": {
      +    "like": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / properties
      Added value: +{
      +  "text": {
      +    "type": "string"
      +  },
      +  "type": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / type
      Added value: +"object"
  20. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "blogId": {
      +      "type": "string"
      +    },
      +    "blogName": {
      +      "type": "string"
      +    },
      +    "brandMentions": {
      +      "items": {
      +        "properties": {
      +          "brand": {
      +            "type": "string"
      +          },
      +          "mentioned": {
      +            "type": "boolean"
      +          },
      +          "method": {
      +            "type": "string"
      +          },
      +          "probability": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "commentCount": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "likeCount": {
      +      "type": "number"
      +    },
      +    "nickName": {
      +      "type": "string"
      +    },
      +    "publishedAt": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "sentiment": {
      +      "properties": {
      +        "confidence": {
      +          "type": "number"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "snippet": {
      +      "type": "string"
      +    },
      +    "sponsored": {
      +      "properties": {
      +        "affiliate": {
      +          "type": "boolean"
      +        },
      +        "affiliateEvidence": {
      +          "items": {
      +            "properties": {
      +              "source": {
      +                "type": "string"
      +              },
      +              "type": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "evidence": {
      +          "items": {},
      +          "type": "array"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "method": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        },
      +        "scores": {
      +          "properties": {
      +            "self_paid": {
      +              "type": "number"
      +            },
      +            "sponsored": {
      +              "type": "number"
      +            },
      +            "unclear": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  21. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "blogId": {
      -      "type": "string"
      -    },
      -    "blogName": {
      -      "type": "string"
      -    },
      -    "brandMentions": {
      -      "items": {
      -        "properties": {
      -          "brand": {
      -            "type": "string"
      -          },
      -          "mentioned": {
      -            "type": "boolean"
      -          },
      -          "method": {
      -            "type": "string"
      -          },
      -          "probability": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "commentCount": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "likeCount": {
      -      "type": "number"
      -    },
      -    "nickName": {
      -      "type": "string"
      -    },
      -    "publishedAt": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "reactions": {
      -      "properties": {
      -        "like": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "sentiment": {
      -      "properties": {
      -        "confidence": {
      -          "type": "number"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "snippet": {
      -      "type": "string"
      -    },
      -    "sponsored": {
      -      "properties": {
      -        "affiliate": {
      -          "type": "boolean"
      -        },
      -        "affiliateEvidence": {
      -          "items": {
      -            "properties": {
      -              "source": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "evidence": {
      -          "items": {
      -            "properties": {
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "method": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        },
      -        "scores": {
      -          "properties": {
      -            "self_paid": {
      -              "type": "number"
      -            },
      -            "sponsored": {
      -              "type": "number"
      -            },
      -            "unclear": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "title": {
      -      "type": "string"
      -    },
      -    "url": {
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
  22. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "blogId": {
      +      "type": "string"
      +    },
      +    "blogName": {
      +      "type": "string"
      +    },
      +    "brandMentions": {
      +      "items": {
      +        "properties": {
      +          "brand": {
      +            "type": "string"
      +          },
      +          "mentioned": {
      +            "type": "boolean"
      +          },
      +          "method": {
      +            "type": "string"
      +          },
      +          "probability": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "commentCount": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "likeCount": {
      +      "type": "number"
      +    },
      +    "nickName": {
      +      "type": "string"
      +    },
      +    "publishedAt": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "reactions": {
      +      "properties": {
      +        "like": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "sentiment": {
      +      "properties": {
      +        "confidence": {
      +          "type": "number"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "snippet": {
      +      "type": "string"
      +    },
      +    "sponsored": {
      +      "properties": {
      +        "affiliate": {
      +          "type": "boolean"
      +        },
      +        "affiliateEvidence": {
      +          "items": {
      +            "properties": {
      +              "source": {
      +                "type": "string"
      +              },
      +              "type": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "evidence": {
      +          "items": {
      +            "properties": {
      +              "text": {
      +                "type": "string"
      +              },
      +              "type": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "method": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        },
      +        "scores": {
      +          "properties": {
      +            "self_paid": {
      +              "type": "number"
      +            },
      +            "sponsored": {
      +              "type": "number"
      +            },
      +            "unclear": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  23. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "blogId": {
      -      "type": "string"
      -    },
      -    "blogName": {
      -      "type": "string"
      -    },
      -    "brandMentions": {
      -      "items": {
      -        "properties": {
      -          "brand": {
      -            "type": "string"
      -          },
      -          "mentioned": {
      -            "type": "boolean"
      -          },
      -          "method": {
      -            "type": "string"
      -          },
      -          "probability": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "commentCount": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "likeCount": {
      -      "type": "number"
      -    },
      -    "nickName": {
      -      "type": "string"
      -    },
      -    "publishedAt": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "reactions": {
      -      "properties": {
      -        "like": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "sentiment": {
      -      "properties": {
      -        "confidence": {
      -          "type": "number"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "snippet": {
      -      "type": "string"
      -    },
      -    "sponsored": {
      -      "properties": {
      -        "affiliate": {
      -          "type": "boolean"
      -        },
      -        "affiliateEvidence": {
      -          "items": {
      -            "properties": {
      -              "source": {
      -                "type": "string"
      -              },
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "evidence": {
      -          "items": {
      -            "properties": {
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "method": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        },
      -        "scores": {
      -          "properties": {
      -            "self_paid": {
      -              "type": "number"
      -            },
      -            "sponsored": {
      -              "type": "number"
      -            },
      -            "unclear": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "title": {
      -      "type": "string"
      -    },
      -    "url": {
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
  24. Changed2 schema fields changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / properties
      Added value: +{
      +  "text": {
      +    "type": "string"
      +  },
      +  "type": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / type
      Added value: +"object"
  25. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / source
      Added value: +{
      +  "type": "string"
      +}
  26. Changed4 schema fields changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / reactions / properties / impressive
      Removed value: -{
      -  "type": "number"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / source
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / properties
      Removed value: -{
      -  "text": {
      -    "type": "string"
      -  },
      -  "type": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / type
      Removed value: -"object"
  27. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  28. Changed2 schema fields changed
    • addedOutput schema / properties / tip / properties / caveat
      Added value: +{
      +  "description": "Present when this session cannot run the Actor the tip recommends",
      +  "type": "string"
      +}
    • changedOutput schema / properties / tip / properties / recommendedActorId / description
      Previous value: -"Apify Actor ID the tip recommends running next, when it names one — pass directly as `actor` to call-actor or fetch-actor-details"New value: +"Apify Actor ID the tip recommends, when it names one"
  29. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "source": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  30. Changed2 schema fields changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / properties
      Added value: +{
      +  "text": {
      +    "type": "string"
      +  },
      +  "type": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / type
      Added value: +"object"
  31. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "blogId": {
      +      "type": "string"
      +    },
      +    "blogName": {
      +      "type": "string"
      +    },
      +    "brandMentions": {
      +      "items": {
      +        "properties": {
      +          "brand": {
      +            "type": "string"
      +          },
      +          "mentioned": {
      +            "type": "boolean"
      +          },
      +          "method": {
      +            "type": "string"
      +          },
      +          "probability": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "commentCount": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "likeCount": {
      +      "type": "number"
      +    },
      +    "nickName": {
      +      "type": "string"
      +    },
      +    "publishedAt": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "reactions": {
      +      "properties": {
      +        "impressive": {
      +          "type": "number"
      +        },
      +        "like": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "sentiment": {
      +      "properties": {
      +        "confidence": {
      +          "type": "number"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "snippet": {
      +      "type": "string"
      +    },
      +    "sponsored": {
      +      "properties": {
      +        "affiliate": {
      +          "type": "boolean"
      +        },
      +        "evidence": {
      +          "items": {},
      +          "type": "array"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "method": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        },
      +        "scores": {
      +          "properties": {
      +            "self_paid": {
      +              "type": "number"
      +            },
      +            "sponsored": {
      +              "type": "number"
      +            },
      +            "unclear": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  32. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "blogId": {
      -      "type": "string"
      -    },
      -    "blogName": {
      -      "type": "string"
      -    },
      -    "brandMentions": {
      -      "items": {
      -        "properties": {
      -          "brand": {
      -            "type": "string"
      -          },
      -          "mentioned": {
      -            "type": "boolean"
      -          },
      -          "method": {
      -            "type": "string"
      -          },
      -          "probability": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "commentCount": {
      -      "type": "number"
      -    },
      -    "imageCount": {
      -      "type": "number"
      -    },
      -    "likeCount": {
      -      "type": "number"
      -    },
      -    "nickName": {
      -      "type": "string"
      -    },
      -    "publishedAt": {
      -      "type": "string"
      -    },
      -    "query": {
      -      "type": "string"
      -    },
      -    "reactions": {
      -      "properties": {
      -        "impressive": {
      -          "type": "number"
      -        },
      -        "like": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "sentiment": {
      -      "properties": {
      -        "confidence": {
      -          "type": "number"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "snippet": {
      -      "type": "string"
      -    },
      -    "sponsored": {
      -      "properties": {
      -        "affiliate": {
      -          "type": "boolean"
      -        },
      -        "affiliateEvidence": {
      -          "items": {
      -            "properties": {
      -              "source": {
      -                "type": "string"
      -              },
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "evidence": {
      -          "items": {
      -            "properties": {
      -              "text": {
      -                "type": "string"
      -              },
      -              "type": {
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "label": {
      -          "type": "string"
      -        },
      -        "method": {
      -          "type": "string"
      -        },
      -        "probability": {
      -          "type": "number"
      -        },
      -        "scores": {
      -          "properties": {
      -            "self_paid": {
      -              "type": "number"
      -            },
      -            "sponsored": {
      -              "type": "number"
      -            },
      -            "unclear": {
      -              "type": "number"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "title": {
      -      "type": "string"
      -    },
      -    "url": {
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
  33. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / affiliateEvidence / items / properties / text
      Added value: +{
      +  "type": "string"
      +}
  34. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / reactions / properties / impressive
      Added value: +{
      +  "type": "number"
      +}
  35. Changed2 schema fields changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / properties
      Added value: +{
      +  "text": {
      +    "type": "string"
      +  },
      +  "type": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / sponsored / properties / evidence / items / type
      Added value: +"object"
  36. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "blogId": {
      +      "type": "string"
      +    },
      +    "blogName": {
      +      "type": "string"
      +    },
      +    "brandMentions": {
      +      "items": {
      +        "properties": {
      +          "brand": {
      +            "type": "string"
      +          },
      +          "mentioned": {
      +            "type": "boolean"
      +          },
      +          "method": {
      +            "type": "string"
      +          },
      +          "probability": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "commentCount": {
      +      "type": "number"
      +    },
      +    "imageCount": {
      +      "type": "number"
      +    },
      +    "likeCount": {
      +      "type": "number"
      +    },
      +    "nickName": {
      +      "type": "string"
      +    },
      +    "publishedAt": {
      +      "type": "string"
      +    },
      +    "query": {
      +      "type": "string"
      +    },
      +    "reactions": {
      +      "properties": {
      +        "like": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "sentiment": {
      +      "properties": {
      +        "confidence": {
      +          "type": "number"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "snippet": {
      +      "type": "string"
      +    },
      +    "sponsored": {
      +      "properties": {
      +        "affiliate": {
      +          "type": "boolean"
      +        },
      +        "affiliateEvidence": {
      +          "items": {
      +            "properties": {
      +              "source": {
      +                "type": "string"
      +              },
      +              "type": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "evidence": {
      +          "items": {},
      +          "type": "array"
      +        },
      +        "label": {
      +          "type": "string"
      +        },
      +        "method": {
      +          "type": "string"
      +        },
      +        "probability": {
      +          "type": "number"
      +        },
      +        "scores": {
      +          "properties": {
      +            "self_paid": {
      +              "type": "number"
      +            },
      +            "sponsored": {
      +              "type": "number"
      +            },
      +            "unclear": {
      +              "type": "number"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  37. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnly=false, destructive=true, openWorld=true; the description adds genuinely useful operational context: no login required, roughly 6 minutes per 1,000 posts, and pay-per-post billing. That cost/latency/auth profile is exactly what an agent needs before committing, though it never explains the destructiveHint in terms of credits consumed or dataset writes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two compact sentences with no filler, and the pricing/latency constraints are stated up front. The opening clause about calling the Actor and retrieving results is wrapper boilerplate that could be dropped.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 14-parameter Actor with full schema coverage and an output schema, the description covers purpose, cost, runtime, auth, language of queries, and the nearest alternative. It omits any hint about polling behaviour when the wait cap is hit, but waitSecs and nextStep in the schema already handle that.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so nearly every parameter is already documented in detail, including the judged-posting charges and maxPostsPerQuery limits. The description only adds that queries are Korean keywords, which duplicates the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource (Naver Blog posts by keyword) and the analyses performed (sponsored post detection, sentiment, brand mentions), which is far more than the tool name conveys. It is slightly muddied by the boilerplate opener about calling the Actor, but an agent can still tell what it does and how it differs from leoworks--naver-shopping-rank-tracker.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says 'Use for blog posts' and routes shop-rank needs to leoworks/naver-shopping-rank-tracker, so the main sibling ambiguity is resolved. It also notes queries must be Korean keywords. There is no guidance on when not to use it beyond that one sibling, so it falls short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.