SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场realestate-report-pdf

realestate-report-pdf

办公与效率

查看项目

更新于 10-16 05:39

技能介绍

用途

该技能用于将 AI 房地产分析系统生成的 Markdown 分析文件转换为专业、可直接交付客户的 PDF 报告。Markdown 适合内部工作分析，但客户、经纪人和投资者需要更正式的 PDF 交付物。该技能把原始分析文件转化为带有评分仪表盘、数据表格、财务预测、图表和明确投资建议的视觉化 PDF，可附加到邮件、在会议中展示或交给贷款方。

主要能力

  • 扫描当前目录下所有 PROPERTY-*.md 文件，识别并提取最新版本的分析数据。
  • 支持的数据来源包括：PROPERTY-ANALYSIS-.md（完整分析及综合评分）、PROPERTY-COMPS-.md（可比销售）、PROPERTY-RENTAL-.md（租金收入与现金流）、PROPERTY-NEIGHBORHOOD-.md（社区评分）、PROPERTY-INVEST-.md（投资情景与 ROI）、PROPERTY-MARKET-.md（市场状况）、PROPERTY-FLIP-.md（翻新分析）、PROPERTY-COMMERCIAL-.md（商业分析）、PROPERTY-MORTGAGE.md（按揭计算）、PROPERTY-COMPARE.md（对比）、PROPERTY-LISTING-.md（挂牌描述）、PROPERTY-SCREEN-.md（筛选结果）。
  • 将提取的数据组装为结构化 JSON 载荷，包含房产地址、报告日期、房产类型、挂牌价、卧室/浴室/面积/地块/建成年份、综合评分、等级、信号、各分类评分及权重、可比销售列表、估值、每平方英尺价格、租金估算、净现金流、资本化率、现金回报率、总租金乘数、空置率、学校评分、步行/公交/自行车评分、安全评级、增长前景、最佳策略、5 年 ROI 预测、风险等级、市场类型、中位价、上市天数、库存月数、价格同比趋势、关键发现、风险因素、建议及执行摘要。
  • 通过专用 Python 脚本生成 PDF；若脚本不存在，则使用 ReportLab 内联动态构建 PDF。
  • 生成的 PDF 包含以下页面：封面页（报告标题、地址、彩色评分仪表盘、等级与信号、报告日期、免责声明）、房产概览、可比销售分析、现金流预测、社区评分卡、投资分析、市场状况、建议与后续步骤。
  • 支持多房产报告：检测所有唯一房产，询问用户选择单个或全部；若选择全部，则生成带对比摘要页的多房产报告，每个房产有独立章节，最终页包含并排对比表。
  • 数据质量标记：根据运行的分析代理数量和文件新鲜度，在 PDF 中显示高置信度（绿色对勾）、中等置信度（黄色警告）、低置信度（红色标记）或数据陈旧警告横幅。

使用方式

触发命令：

  • /realestate report-pdf — 从所有可用分析文件生成 PDF
  • /realestate report-pdf <address> — 为特定房产生成 PDF
  • 也可通过“generate PDF”“create PDF report”“make a client report”“professional report”等短语触发。

执行流程：

  1. 检查专用 Python 脚本是否存在：ls ~/.claude/skills/realestate/scripts/generate_realestate_pdf.py 2>/dev/null。若存在则直接使用；若不存在则用 ReportLab 内联生成。
  2. 扫描当前工作目录中的 PROPERTY-*.md 文件，查找每类文件的最新版本。若无历史数据，建议用户先运行 /realestate analyze <address>；若用户坚持，则询问地址并通过 WebSearch 快速收集数据，至少运行等效于 /realestate quick <address> 的操作以填充基本评分。
  3. 从各分析文件中提取关键数据点。
  4. 构建 JSON 数据结构。
  5. 运行 PDF 生成脚本：python3 ~/.claude/skills/realestate/scripts/generate_realestate_pdf.py。若脚本不存在，则用 Python 和 ReportLab 内联生成。
  6. 验证并交付：确认文件已创建，报告文件名、位置、大小、页数、包含的数据来源及数据缺口。

输出规格：

  • 文件名：PROPERTY-REPORT.pdf（或指定地址时 PROPERTY-REPORT-[ADDRESS].pdf）
  • 页面尺寸：Letter（8.5" x 11"），纵向
  • 页数：6-10 页，取决于可用数据
  • 文件大小：通常 200KB - 1MB
  • Python 依赖：ReportLab（未安装时运行 pip install reportlab）

适用场景

  • 客户演示或邮件附件
  • 贷款方或合作伙伴尽职调查包
  • 董事会或投资者会议
  • 房地产经纪人的销售材料
  • 需要专业 PDF 交付物的任何场景

限制

  • 仅用于教育/研究目的，不构成财务或投资建议。
  • 所有估算均为基于公开数据的 AI 生成近似值，需由持牌专业人士核实。
  • 每个数字必须来自分析文件或实时研究，不得编造数据。
  • 若部分分析文件缺失，PDF 将使用可用数据生成，缺失部分标记为“Not analyzed — run /realestate [command] to add this data”。
  • 若 ReportLab 未安装，需先安装；若安装失败，提供手动安装说明。
  • 若无法写入 PDF（权限错误），建议替代输出目录。
  • 若分析文件超过 30 天，显示“Data may be outdated”警告横幅。
  • 评分颜色编码：绿色（70+）、黄色（40-69）、红色（0-39）。
  • 若已存在 PROPERTY-REPORT.pdf，将安全覆盖（最新数据优先）。