SuperAPI AI 工具集

journalist-media-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:为某个报道选题或公关简报构建相关的记者与媒体候选名单,并解释每位候选人与选题的匹配理由。输出是经过调研的媒体名单;发送投稿属于单独操作,需用户明确要求。

主要能力:使用 Crawlora 的记者数据集、新闻搜索和公开作者页。可先通过 /datasets/journalists/facets(facet=outlet、vertical 或 topic)发现支持的媒体名册与筛选值,再用 q、vertical 及精确的 topic/outlet 值搜索;q 只搜索姓名、头衔和简介,不搜索文章正文。单页 page_size 最大 100,结果窗口上限 10,000 条。用搜索返回的标识符从 /datasets/journalists/items/{outlet}/{slug} 获取记录,并保留媒体维度的身份信息。

使用方式:设置环境变量 CRAWLORA_API_KEY(来自 crawlora.net),在本技能目录或绝对路径运行 scripts/crawlora.sh,它调用 https://api.crawlora.net/api/v1 并携带 x-api-key,输出 JSON。参数与枚举值见 reference/endpoints.md。示例: scripts/crawlora.sh /datasets/journalists/facets facet=outlet vertical=tech scripts/crawlora.sh /datasets/journalists/search vertical=tech page_size=10 scripts/crawlora.sh /datasets/journalists/search q=security page_size=10

工作流:先明确选题角度、相关条线、目标受众/地域和名单规模;仅有产品类别时可能需要更具体角度,优先使用用户提供的简报。用 profile_url、/bing/search、/bing/news 和 /web/scrape 核实当前所属媒体与近期相关作品;将姓名与媒体/域名一起搜索以避免同名混淆;在来源页确认署名与文章日期,搜索摘要只是线索而非已核实报道。按选题契合度与时效性排序,强匹配可引用一两篇相关作品;仅有简介级证据的候选标记为未验证。

输出:表格或 CSV,字段包括 name、outlet、title、beat、profile_url、relevant_article_urls、article_dates、fit_reason、public_contact、contact_source_url、retrieved_at、verification_status。

限制:数据集仅覆盖精选的支持媒体名册,空结果不代表无人报道该主题,可用公开搜索补充并标注外部发现的候选。条线主题为尽力标注;当前署名作品比旧简介更有力。contact_type=email 仅表示媒体页面公布了地址,不代表邮箱已验证或本人愿意接收投稿;social 表示仅找到社交渠道;none 表示两者皆无。不要按媒体邮箱格式臆造地址。除非用户简报要求必须有联系方式,否则保留无联系方式但编辑匹配度高的候选。将搜索限制在请求的名单规模内,并说明任何缺口。遇到 429 应退避;瞬时 5xx 可重试一次;遇到 401/403 应停止并检查应用代码,若其他来源失败则保留已成功的证据。